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This edition of the MPE Release 23 Tables Manual describes the internal table organiza- 
tion of the MPE V operating system. It is intended for the technically sophisticated user 
with Privilege Mode capability. We strongly discourage modifying the contents of the 
MPE tables because you may destroy the operating system. The following caution applies: 


The normal checks and limitations that apply to the 
standard MPE users are bypassed in Privileged Mode. It 
is possible for a Privileged Mode program to destroy file 
integrity including the MPE operating system software 
itself. Upon request Hewlett-Packard will investigate 
and attempt to resolve problems resulting from the use 
of Privileged Mode code. This service is available on a 
time and materials billing basis. However, Hewlett- 
Packard will not support, correct, or attend to any 
modifications of the MPE operating system software. 
Hewlett-Packard reserves the right to change the struc- 
ture and the content of any system tables in future 
releases of MPE. 


The major highlights of this edition include: 





e Corrections/Additions were made in bringing the information up to Release 23. 


We hope you will find this edition informative. Your comments and suggestions are welcome via the 
"Reader Comment Sheet" at the back of this manual. 
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HAPTER 1 MEMORY LAYOUT Fixed Low Meno Serres 44/48 68 Cont. 
Fixed Low fen Serres _3x/4x/Sx/6x/70, Micros | enewennwnnnnrcnenonecwn ee en ne nnnenennenennne= | 
25| TR (TINE SINCE LAST SOFT TIMER {21 
| INTERRUPT) ** [ 
I | easeensenneenesenseconsecensanswweesasesenss |OEC | eomn nnn nnn nnn coe nn nnn enne nner crcenecnssecece | 
| CSTB (BASE OF CST TABLE)** |0 ee SCST (SYSTEM CLOCK STATUS) ** i 
|-neeecnnnnnonenasornenerernennnnconnencecee= f acne nnnnceesnnnannnnarnarsnnncresssceecneenns 
1{ XCSTB (POINTER TO CURRENT EXECUTING \1 27| SCLC (SYSTEM CLOCK LAST COUNT)** {23 
| PROGRAM BLOCK) | | poe n nen nnn nnn nnn nn nnn ne enn www nnn eennenewwene | 
| poow een nn nore rene cence noose neeeces -weeenen | X-37| 124-31 
¥ OSTB (BASE OF OST TABLE)** ? | conn nn mewn enn nn ne wenn on nwn ewww wcweownnren- a= j 
a 0 hi NOTE: R1l pointers are absolute addresses. 
4| CPCB (CURRENT PCB INDEX)** 14 >PCB REL LEGEND: ** Needed by Firmware and/or by Systen, aluays 
| com n ecw cer ensenmnennenesasencesesananceusonne | -® Needed during INITIAL 
t QI (INITIAL Q FOR ICS)** 3 + Needed by APE, set up by INITIAL or PROGENITOR 
| ZI (INITIAL Z FOR ICS)** Is 
7 SYSTEN INTERRUPT MASK WORD** 
10] ORTBANK (BANK OF ORT TABLE) \8 
11] ORTADOR (BASE OF DRT TABLE) ? 
12] DBGANK (FOR INITIAL’S STACK)* {10 
13| 08 (FOR INITIAL’S STACK)® j11 
a \12 
15| \13 
|------- wannnneennecennenncnmencenenenennnonn= 
16| | 14 
17| 115 
|---wennennnannnnenneeernnnnnnnennnnnnnnnmnnne| 
20) \16 
21 LR (INTERRUPT INTERVAL)+ |17 


| 
22| TEMPLR (TERP STORAGE OF Luni REG) 118 


dad 


23| LR (SYSTEN CLOCK LIMIT REGISTER)** {19 




















| ----n-n-—--nnonnnnnnenwnnnnnnwnennennanennens | 
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Renory Layout Menory Layout 
Systen Global Ares Systen Global Area (Cont. 
| 1799999 — Jf fewcewonorc cecewewnccwencerenenwncoerenesessnose | 
! Scrat °, ip : 3 of ei of . ;, yi ‘ a 3 of WANE 26| VOSATRB BRSE en 
* SYSGLOB | 27| STATIC FENCE (# CONFIGURED MEMORY EANKS) | 
1| CST BASE |CsT = CURRENT CST BLOCK INDEX ICSTBX 
| Zi DST BASE OST 31| NEASIO BASE [NERSIO 
| 3| PCB BASE {Pca 32| DISPLACENENT TO CODE = @CST(0)-@DST(0) pre 
P | 4l SUAPTAB BRSE {SUL 33] DISPLACEMENT TO | 
| | pocecewewcwnewennwcwncwcnrwecsennnroccoococwoes | | SRARRBLE zs @CST( LAST )-@0ST(0) ors 
| 5| 100 BASE 109  Kastenetertastatateatatienettetat atta etatetatatat ater ateatatacnatatnatatatatataeratatae | 
| wecnwen cece enencecccwcewsceseseewncssconcocec= | 4| SMON INDEX | 
| 6| SBUF BASE | BUF  Kececerietatettetetetatetetetatetatetatattatedataheretanehetensaaatateneraneatataearatatal | 
| | eran new new eww ccweceenern nen ee sre nnnsmcscscose= | 35| ABSOLUTE ADDRESS (SYSDIT(8)) |omTs 
| 7| Ics ar |Ics | eoeemc erence cece n scence co ccnweeweseoccsnosccen | 
| | peewee enn enon ene wcocwernesaessescossseresnens=| 36 RESERVED | SBANK 
| 10| LPOT BASE | LPOT | penn men nn wenn wenn wenn nn ecwennnncesccoeceesene~= | 
11 SHON BASE | SHON | TABLE FOR LST/STT CHECKING | SBASE 
12] TRL BASE {TRL 40| RESERVED FOR INITIAL (VOSENTRY) | 
13 JCUT BASE |SIR 4i| RESERVED FOR INITIAL (VOSNAP) | 
14| SIR BASE {SOCTRS 42| SRITAB BASE |SRTTAB 
15| JPCNT BASE | IPCNT 43| SPECQ HEAD |SPECQHEAD 
16] TBUF BASE tis 44| NUMBER OF AVAILABLE REGIONS apace 
| 17] DISC REQUEST BASE (ORQ 4s| NUNSER OF PRGES IN LARGEST | 
{ | comme wn n ewer cccennesennncnccsccccoesocroocone= | | CURRENTLY AVAILABLE REGION | MAXAVATLREG 
| 20] REMORY ADDRESS OF FIRST | | poewe nnn enn ween new on cnn come ce nes en een cncene | 
I | LINKED 46| MAKE OVERLAY CANDIDATE INFORMATION [MOCINFO 
| 24 MEMORY REGION Poo em emen mn nnn ennncenncscnweensceccncocesocooesose | 
| gee eer a | se NUMBER OF MENORY BANKS CONFIGURED -4 ons 
TIME OF LAST CYCLE | 50| SCHEDULER TO AWAKE MESSAGE Peeenencnee 
| | pecennen ncn enn neecnewnnn owen nnsenesnnnnneenenes| 51| CSTBLK TABLE BASE ADDRESS ICSTXBLCKPOINTER 
| 24| RESERVED |  Teceehateepetaertattetaceat ate atateetetate tetera eatat tate aaa teeta tate Tatated | 
| ae aa ee oe §2| PRIORITY OF PROCESS TO BE SERVICED NEXT  |AWAKETOSCHEONSG 
| 25] BREAK POINT FLAG |UK|SY  |BPTF | poce rem eee cew ewe w ewe cence en enccewceeee-sccecoe | 
| | -----00- wecweweenccncnccenceccesececes | oo |o-eee| a URIT --> DISP COMMUNICATION WD error 
a! CURRENT ACTIVITY’S PRIORITY , | CURACTPRI 
Seumeiee Shades + uae ekceceteeasonueceuwswstoscuas | 
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Renory Layout 
n al firea nt 
| eonn nce neneccnnncccoroccoornoce Siececess wccccee| 

/ 55\ BUSY TABLE POINTER {BUSY 

|. Ac]eesseeesansecesesaeseerteserre=ersssSeerassane= 

| 56] HEAD TABLE POINTER {HEAD 

| _|eennncnwennnnnrnnccccocsoommnne aoneenenennewane 

|} 57] TALL TABLE POINTER peat 

|, Pesereesesseaacnsencereseseesr esos se vasscssses 

| 601 # OF SIO PROGRANS EXECUTING Jalal 

|o_lpetsessessseecassseceeeranesos(SacseHscereitescee 

| 61] PARITY ERROR FLAG (NER PE) oo 

|) > fessesssenseesesonnsdesseeensenseeeenesese=sacee 

| 62] IMPEDED QUEUE HERD | 

j FOR MESSAGE BUFFER (PIN) |IJONSGPIN 

ee Con 

| 63] 1/0 RESSAGE SYSTEN ERROR FLAGS | 

| | (0:4) = NO SYSBUF AVAIL FOR 1/0 ERROR LOGGING | 

| (1:1) - NO SYSBUF FOR IONESSAGE (GENNSG) | TOLOGOX 
RESERVED | 64| # OF TERMINALS READING |ROCOUNT 
FOR 1/0 « | erecccc cnc cre wenenwennnnnnnenennne woccenccce | 
SYSTEN =| @ OF TERMINALS URITING {URTCOUNT 

a DSET 8 hea 

| 67] |CRIO 

i of LAST TINER | 

ai |CRIO 

| m HIGHEST DRT NUMBER |HSYSORT 

i POWERFAIL email 

| ie SYSTEM UP FLAG jsysuP 

\ ro SYS CONSOLE LOGICAL DEVICE NUMBER ‘paca 

; 7§| COLD LOAD COUNT eit 

! a SHARED FCB OST |SHFCEDST 

! a MONITORING FLAGS 
RESERVED [100] | 
FOR FILE< | MAX # OF SPOOL SECTORS |MAXSSECT 
SYSTEM | 101] | 

| [eceeetenreneennnnnnnncnnnnweenneenennenennnnnne| 
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RESERVED< 


FOR CS 


132] SPOOLINDEX | 


SSS OES 6 OO 8 6 © HOS 8088 OOS8S8 £088 0288S 0288SE8ES FESS OS4O8SEU8 


— EXT LABEL FOR SHONCON 











1134] | 
cl imate. CC 
ia ean 
a sa. 
Aol CoUUSE PUABEL eae 
isi] Occ RacESS TOE ROE) 
142] LOGICAL PROCESS TABLE (RESSENGER) 
1aat LGICAL PROCESS THEE (GOP) 
14s LOGICAL PROCESS THLE GFE) 
sel esta pce i ee 
Wl I 
ae ea 
1so| aston vaotess TELE (WS) | 


151] LOGICAL PROCESS TABLE (LORD) 


SOOO O 0 2 OO BOS 6 OOS EOS SSE GOES SES SSOS STROSS SSOOSOCEO 


152| LOGICAL PROCESS TABLE (IOMESSPROC) 


| 
153} LOGICAL PROCESS TABLE (SYSTOPRDC) 


154 LOGICAL PROCESS TABLE (NENLOGP) 


OOO OO © 6 6408 6S OO2O8O8GOOSE 6 OS9E924E4E 2 O9SSE SES SS2SBES48084 | 


185] EXTERNAL PLABEL 6 OF “TERMINATE” 


| 
156| INTERNAL PLABEL 0 OF “TERMINATE” 


e2e82e808e2088088 FF OO 99S SSS SS 2682S 8S 0SS0SE SOSSGSHSEEEE® 
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a CURRENT @ OF SPOOL KILOSECTORS {NUNSSECT 
{103} j 
ot] W SECTOR/SPOOLFILE EXTENT. SSCS \EXTSSECT 
Gn Morera |. | 
106\ mn w OF Cope SEOneNTs/PRaceSS | 
il anc GO | 
10) DEFAULT STACK SE 
i) Mn Eto DATA SEEN SE | 
a) ad i os SeaEMcenESS 
113) DST MANGER FOR ESSAGE EFEERS | 
4) UOTE LEVELSs“‘( as”*é<i;~;<i‘<‘<i<;CS;ét~™S (UPDATEL 
ia ae {Fret 
“ wae IvERSTON 
vl RUT TIE AT | 
ol 8 OS | 
al” deem as a) | 
122}. EXTERNAL PLABEL OF IMITIAIE 
12a, IMERMAL PLAREL OF IMT | 
a mE oO | 
| ST Seen en | 
126|  LDEV FOR SLPUBLSYS | MODA FOR SL.PUB.SYS | 
ol aes CC ! 
nl COR) 
‘ail (OISC ADDRESS) ! 
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st bal A nt. 


| S806 88208 0OO28E4E 28S OE86 28SEE 6 O08 SSSSES8SSS2E82SE 88880 | 


157| EXTERNAL PLABEL OF "COMMANDINTERP™ | 
1 IWeiWnL PLBEL OF *COMNDTATERD™ | 
ie exiewaL PuBEL OF SPOOL | 
see IWTERWnL PLAREL OF THRCEOR | 
teal eww PUBEL OF "TCE 
1a ema uvaEL OF SPOOL | 
tes] Eon. ABEL OF “SOOT | 
ies Iwo PURE OF "SPOOL! | 
ni 
1170], 3 WORD LCGGING AASK | 
7] " 


| 
\172] STATE | DSTW - BUFFER 0 |STRTE: 


wcewccccnne | anceecec-anocensccnn-sseccenenencn=| 0 EMPTY 


1173] STATE | OST# - BUFFER 1 1 1 CUR 


wn newecencc]or panna eecew ee nenemewecerencecnee| 2 FULL 


| 
\174| BUFFER LENGTH (SECTORS) 


la751 FREE AREA POUIEN | 
a a aaaas| 
chal Te neces RETTEN IV BFE OS 
| col a RecONDS URITIEW IN EUR 
ol File Suze (IES) STE 
leek FILE SIZE (US) SD LE 
os) MS) CSS 
a ee a 
far ueHiEMmen Gieicen 
ios) 0 GF Luce: BIS ITEMS) | 
ian ae oe Ee nite 
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Systen Globa] Area (Cont.) Systen Global Area nt. 
wmwmeccaccccceenssscc scree ecens cceweeccccccwoce | wii oe toute eelstdeees cbeseasdo eee ssesceeesd, 
{210| (TOTAL # LOG RECORDS AISSED) | aaa CURRENT WORD COUNT |XOSCOUNT 
lait} (DUE TO LOG FATLURE) seamen 1255] BUFFER SIZE ee 
|  fewwe nnn n nnn ween nese nen necnweencoccccoeencoorrs (| www ence cmmm wenn nner cen weneenasoserewcccocece 
}212| TOTAL # RECORDS MISSED | )256| MAG TAPE LDEV | LEV 
i - "JOS INITIATION” LOSS Bee  —“—C~iYC CR RRR RR RTE RRR Ree re eee ee 
a ee ne ene | \257| TRACE SEGMENT EXTERNAL LABEL [TLABEL 
LOGGING < 213] TOTAL # RECORDS MISSED a a aa a 
t | - "JOB TERMINATION" LOSS a STMON 
| (Jeet eeectcemeccereceeesecctecewessceescsessesf ff ig Retest rence nencoossensnsenneastenenasenacesn= 
\214] OPERATOR CONSOLE | 261] MEASINFOTABPTR | 
| JOBSESSION $ AT STARTUP | [SeSearatneneer sede eenaessesecesesceneerersora= | 
ee ae | 262| MEASUREMENT STATISTICS CLASS MASK |GCLASSENABLED 
215] ccc a ae rs 
216| RESERVED FOR KERNEL USE | 263] CLASS 0 STATISTICS BANK NUMBER | MEASSTRTXDSBANK 
217| . “i, hg IRAE RRS eseee serene ererssareee etn Tees Saenar == 
ee ng | 264 | CLASS O STATISTICS ADORESS |MEASSTSTXOSBASE 
220] MAPPING FIRMWARE FLAG Bo00Ctti—itsts—‘“CS™CS SA Senne trees n eer ceseceesneseatens ares Sree t === 
| BIT 15 V/EXPANSION | 265] PERFORMANCE FEATURE SET | 
| BIT 14 PREC | | cowcewccccererroesocsoncceconnnccoren Ssasesess< | 
| BIT 13 $/70 ae MEMORY SCAN POINTER jsafexped| ! 
221 | BANK / BASE ADDRESS OF MAPPING DST | | 267) MEASF LAGS yet | 
| (INITIALIZED BY DISPATCHER | [| «_— row w oon ewcnewocneronsesencccocene|e~| sol -ofoe | 
222| DURING LAUNCHING A PROCESS) 270] HEWLETT-PACKARD DATA BASE (HPDS) | 
=n ee OF CODE SEGNENTS OF CURRENT ! ee INDEX OF PCB AT HEAD OF DISPATCHING Q ae 
OCESS- a s—i(ité«C YL RRR RS CRS SORES SESE RST E Srna R ese T ones Tees S= 
cocccoweweweece cece ecccsccccecoccccoscsecee | {272| INDEX OF PCB AT TAIL OF DISPATCHING Q |SYSDISPQTAIL 
224) TOTAL FREE PHYSICAL CST ENTRIES | J eee nero ccce cree senenencncnecccnscccccccoocores | 
| cocccworecencnmcccconncr cor ccecenrnccnceesenenes | |273] DST # OF COT TRBLE (DISC CACHING) | 
225 | HEAD OF FREE PHYSICAL CST LINK PP  ———— ee AD [eRe ae er neeeresenssnrsannasoreseessreeese sess 
woccewen wn cce renown s soc conn eweccsscnnsoensance | |274 BANK # OF THE CDT TABLE (DISC CACHING) | 
226] XLST OST NUMBER | KERNEL < aetna lteter at tartar aaaiel aeteaaeenaienaieneaaieieaienat | 
aeceennwewecewsccenen ew nwnnsnnenesececoeoceworn | ADORESS OF CDT TABLE (OISC CACHING) | 
227| mm mee w encom concowe renew ocwccecesersconensoonece 
| RESERVED 1 ice HELP LOGICAL DEVICE NUNBER 
Ye | rr a rr a DO a ac 
| eon n nrc cen nnn nm wenn wenn wncr er ensenecncococoen | \277| CURRENT LOGON OST | OSTLOGON 
250 | BANK / BASE ADDRESS | | pone ew ene n nnn nc ecw eccenccoocownnenewewocoorne | 
OF AVAILABLE | [X0| (STOP) | 
2511 REGION LIST HEAD |HLHEAD 1301] (BITS) (see p. 2-15) ! 
252] BANK / BRSE ADDRESS | 1X2] ® PROCESS ENTRIES | 
| OF AVAILABLE | | wowc nen eenwren nec eneecensneccseowenscceseccceee| 
253} REGION LIST TAIL hagas Ria 
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flenory Layout Menory Layout 
ten Global A Con n ai Ares n 
|__ |ncneceneeenncnerennenne | -nnnnnnennnonennnnenee= | -------nw2nnannnnn-nneemnnnnnmnemnne nnn nnn nnn | 
haat DEVREC PIN 2 | a OSCHECK PLABEL 
hada si 336 OSOPEN PLABEL 
ae UCOP PIN | ) | 337 | OSCLOSE PLABEL ! 
1307] 220 | 340| MANAGEURITE CONV. PLABEL | 
PROCESS | | ss re | ee ee ee enn | eee ct ee 6 cee eter eee cewee comm seeeneneewsseeosee | 
stop 3 « 310] LOG PIN | { | Ai| CONSDSLINE’ PLASEL | 
TABLE |_| nennnnnnnnnnnnnnnnnnnnn |nnnnnnnnnnnnnnennnnnoe=| |---2----e0=- seeeiulsluscine sperma mere eee 
ia a H2| CKREMOTE PLABEL ! 
pe IONESS PIN ! 3 343] CXOSLINE PLABEL 
hae ae 344) CXRFA PLABEL 
a MEMLOG PIN 4 ,; 345 | DSIMAGE PLABEL | 
had 220 346) DEFAULT LABEL TYPE | TAPE LBL AUTO REC FUN 
|316| NMMON PIN | 3? | SYSDB PTR TO TERM INIT CHNL PON | 
|... [eeeeasneenseenarennneasesscedesnssenesasceeser= { | ($30/33 ONLY) | 
\317| 4 | | ce | coe w ewww ew nn een ewnencwesmecenssnsensccce= [oo 
| ewer nn nececorensennarennwenccorcorereecooneror | | 350] MP ISD|MEN PRESSURE 
‘wat DS GLOBAL DATA SEGNENT DST NUMBER | a6 FA aaa FLAS 
wewemecnceenecn cece cnwessseccecceceenccccsccces 1 
hae RESERVED FOR 0S/3000 (SET TO ZERO) | aca} LAST CYCLE OURATION | 
ga: RESERVED FOR 0S/3000 (SET TO ZERO) : ! a woo eS | 
Seeconccesasnennannnsssaussecessessuneccoecsows 353 | 
ia SOS WEV PLASEL ! sent CYCLE THRESHOLD ! 
DS < 324] RESERVED FOR DS/3000 (SET TO ZERO) | a ee eon | 
eae een evn jpn ml aig ae Nana anesae | 355] BUG CATCH ENABLE CELL | 
[325] RESERVED FOR 0S/3000 (SET TO ZERO) | | ------ one one on new nee | -o-o---- 2-22 -- eee i 
| [rowewncc cnr enero sennccenercesec eres: ceceercees| 356| MONITOR BUFFER | TIMESTAMP |NONBUFTO 
1326] RESERVED FOR 0S/3000 (SET TO ZERO) | | enn en wn nnn wece ne eeencee | naenennnnennn ene nnw none | 
bs cleteeenesSensostceeees cee eseses sce0 aso nan | 357| MONITOR BUFFER | TIMESTAMP | MONBUFT# 
\327| RESERVED FOR 0S/3000 (SET 10 ZERO) | ee os 
| eomnnnnnnnnnn nn nen nn nnn neces = ne nn ec nenesen ene] 360| OSBRERK PLABEL | 
3H DISC STATUS {LAST ee ee. 
[spesesesarasscesesscer= | seseesemen ss sseessecscr [Dect 361] BANK / BASE ADDRESS [LAST NENORY 
331] LDEV | brisc S10 OF LAST | 
| eneen nnn nnn nn nn nnn wne nn | con ern nn nn mene mene onne= |EREOR 362 | MEMORY WORD {ADDRESS 
332 | RONESS FF 90S 688508 OSE OBS O9S O9S89OS8SOSS2S899S 028980880 j 
333| MAXQUEVE | 
crecocorerce wrewer wwe nnnns conne- n+ ee enceceen <= | INEPRI 


| DEFAULTQUEUE 


6.23.00 6.23.00 
1- 11 1- 12 


! 
/3631 


1364| 

PRIVATE < | 
VOLUMES toad 
1366| 

i | 

|367| 

| | 

ve) 

| at 
372| 
373| 
374) 


375} 


flenory Layout 
n Globa) A Con 

ec eccwneaccccncnsncscersasecccccsenaasenccsece | 
| PYPROC PIN | 
PV RECOGNITION COUNT | 
VMOUNT FLAGS JMT{AULALION} 
|eeeeen-e- see secrssereneenaeses sees Jo-}--}--l--| 
| 
KucQseuiususseenedeacvbsewssoucescsiwecesseoues | 
| 
us gia ebalsolaouueecewavesewessesseececessasdssc. | 
| 
HSG CATALOG LDEV | 
MESSAGE CATALOG DISC ADORESS 
MSG DST 
CONSMPLINE’ PLABEL 
CONSARJE PLABEL 
SYSTEM LEVEL UDC FLAG | 
(1 = SYS UDC'S EXIST) | 


376| 
| 


377| 
| 


SYSDB RELATIVE POINTER TO SYSGLO8 | 
EXTENSION 


400| 
(1 
| 
\402] 


&& MEASF LAGS 


CPU NUMBER ( SET BY SOFTOUNP ) | 


SO SBOGS COSHH ABESAOSCOSCSE OP ODODE BOS BSED SEDSLHASCOSO 


MICROCODE MEMORY LOCATIONS 


| 
| 
SNOTE THAT THE CONTENTS DEPEND ON THE TYPE = | 
OF CPU THAT APE IS RUNNING AND WHETHER A | 
DUMP, POWERFAIL, OR CNTL B/HALT HAS OCCURRED | 


(12:1) 2 1 © Tape Error VAOUNT Flags: AT - mount 
(13:1) = 1 # EOT on Monitor Tape AU - auto 
(14:1) 2 1 = Buffer Flip/Flop AL - all 


(15:41) = 1 s Monator Enabled ON - on 


The following locations refer to all systens: 


21401 = DUNPDEVORT 71406 = Q 


1402 = X 
1403 = OL 


21413 = PB - BANK 
1407 ® S 1414 = PB 
1410 © § - BANK 1415 = P 


1404 = 08 - BRNK 1411 27 1416 = PL 


| 
| 
: 1405 = DB 


Systen Halt Fi 


ae NT, eA SY oo STL * SST 


1412 = STATUS 1417 = CIR 


1420 = High Bank 
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ag: 0 - Unexpected (unknoun) Interrupt 
1 - STT Violation in Segment @1 
2 - Absent Segnent while executing on the ICS 
3 - Absent or Trace on Segnent #1 
4 - Stack Overflow on the ICS 
5 - CST Table length (word 0) found to be 0 
6 - Bootstrap Channel Progran Timeout 
7 - Bootstrap Checkeun Error 
8 - Bootstrap Channel Progran Abort 
9 - PSEB Instruction while QI-18 = 0 
10 - Module Send Message Tinecut 
11 - Incorrect Module ecpenes re 
12 - Channel not Systen Controller 
13 - Code Segnent Violation uhile in Segnent #1 
14 = Non-responding Channel 
15 - Channel © Responding (to IPOLL) 
16 - No CSRQ or IRQ on Message Interrupt 
17 - Channel cannot be nade Lontroller-in-charge 
18 - Module Receive Message Tineout 
19 - 1/0 Error, Parity or Tineout 
20 - UCS Checksun Error 
21 - LUT Checksun Error 
22 - Bad CPU Connand Code 
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Renory Layout 


The following locations refer exclusively to the Series 37: 


21421 = Microcode Version Nunber 
Bit (0:2) OO = Master Released 
10 = Pending Release 
11 5 Experinental 
Bit (2:6) Base Level (1-64) 
Bit (8:8) Patch Level (1-99) 
21422 = Flags/Misc 
BIT (0:1) 1 If On ICS 
Bit (1:1) 1 If In Dispatcher 
Bit (2:1) Logacal/Physical 
1 If Logacal 
Bit (3:1) 1 If Channel Progran Is Running 
Bit(4:1) Split Bank Flag 
1 If Split 
8it(5:3) Unused 
81t(8:8) Last Stop Code 
11423/7377 = Channel Progran Area For Booting Sof tuare 
(Used Only During Boot). 


The following are assignnents after softuare has been loaded and launched: 


%1540/1617 = ROM Input Buffer For Terninal 1/0 
1620/1677 = ROM Output Buffer For Terninal 1/0 
1700/1710 = ROM Control Buffer For Terminal 1/0 
1711/1737 = ROM Control 6 Interface Buffers 


| The following assignnents refer to the Series 3x/4x/Sx/6x/70,Nicros 
i 30/33/39/4x/5x 6x/70 
Z1421 = CPX1 Register 

1422 = CPX2 Register 


1514 s Systen Halt Flag 
21515 = WIR Register 


21421 = Systen Halt # 
1422 = ISR (Interrupt Register) 


21515 = Systen Interrupt Mask 


1516 = DRT O 
} 1817 = ORT 1 37/6x/70, ficros 
1520 = ORT 2 
1$21 = DRT 3 1516 = ORT 0 
1§17 = ORT 1 
1520 = ORT 2 
1521 = ORT 3 


1522 = ORT Bank 

1523 = DRT Addrese Offset 
(6x/70 only) 1524 = Interrupt Mask For INGO 
(6x/70 only) 1525 = Interrupt Mask For INB1 
(6x/70 only) 1526 = Interrupt Rask For IMB2 
(6x/70 only) 1527 = Interrupt Mask For INB3 


1740 = Start Of SysGleb Extension 


All Systens: 


6.23.00 
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xtension 


%200 uords long; Pointer found at SyeDB ¢ 2377 


| 28 OO 08 B@ OSS COS OS 68288204 OOS 6 © SS2SE SESS SES SOSSOBEESCO | 


z . SUAP QUEUE DELAY (*100RS) eee 
1| BANK / BASE ADDRESS JFIRST 
| OF FIRST MEMORY | MEMORY 
2| REGION IN LINKED MEMORY |REGION 
3} GARBAGE COLLECTION ENABLE FLAG |GARBCOLLENAS 


SOS © 0 OS CO SSS SS GO8E2H980E 5240S €OS8OSS2SE4 2ESSOSE9880088 


| 
4) MOVE THRESHOLD (IN PAGES, FOR GARB COLL) |MOVETHRESH 


POS OS OC C6 BOSSES 8 0888 8SE8SE2 EE 28 6E9SSES SE GODSZESESSSEEHSBO 


5| MAIN MENORY PAGE SIZE (IN WORDS) 


20S 806 088 08080800288 S OES 68 9SEO9OOSSSESSSESBOSSOSSTO8 | 


‘| VOS PAGE SIZE 
7\ | HOTINELAST- 
| TINE OF LAST MAXEROOM CALL | MAKEROON 
l | LOTIMELAST- 
mt es 
mT MEMORY PRESSURE DURATION THRESHOLD | 
12] NATIVE LANGUAGE TABLE (NLT) OST @ i 


13| RESERVED FOR NATIVE LANGUAGE SUPPORT } 


PSS OO OOS COS BOSSES 9E9S9SE9F288ESEE 46 BOOSOOOSSOESESTO 


14| BAUD RATE OF THE SYSTEM CONSOLE 


S806 C6 CEFF OF C88 OS OSSOSSSE O8SE S08 24 OS TSSOOHSOSSSCO 


15] INITIAL UDEV OF SYSTEM CONSOLE | 
16) - PURBEL FOR REMOTE’ APE | 
17] —- PLRBEL FOR GETDS’ NODENANE | 
2 UCS VERSION 
21| WORD O RICROCODED PROCEDURES, 

| PERFORMANCE FEATURE SET BIT nap 
22) WORD 1 NICROCODED PROCEDURES, 

PERFORMANCE FEATURE SET BIT RAP 


PERFORMANCE FEATURE SET BIT RAP 


8 8 OBO W 8 OOS OS OO OO COS FG & 8 O4SSE4E 2HHSSSOSSSEOSBOESSEOS 


| 
sd WORD 2 MICROCODED PROCEDURES, 


24! WORD 3 MICROCODED PROCEDURES, 
| PERFGRMANCE FEATURE SET BIT RAP 
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Henory Layout Renory Layout 
For Word 3(224) the following applies: i i st—i(‘<“<CS~SsSsSs [ne rm nner rere rn ern nnn rer cnr ero wrereresserrocoos | 
eas EE OR ad oP 77| COUNT OF TAPE CONTROLLERS USING REASIO | 
Bit 15 is set if ERRORON'70 18 present | penn emnnnnnn ncn nnnn nn nen nn en nn nnn er enenneeeeeee | 
Bit 14 18 set if ERROREXIT’70 is present 100| PORT DATA SEGRENT NURBER | 
Bit 13.18 set if EXCHANGEDB’70 is present 0 i —i—ies—‘“‘“<—<“<COtes fe fener rere ne rn rr errr re rn ecccceresorerererecere | 
Bit 12 is set if TINMER’70 1s present 101! RESERVED FOR SECOND PORT ORTA SEGHENT | 
Bat 11 is set if TIMEREQ’70 is present BE! 4 4 BeBe ee eg ge he ee ee Oe 
Bit 10 as set if MMSTAT’70 1s present ¥ ; SYNSEM FPRAP OPTION FLAG |SYSFPRAP 
. e 103] | 
SetebesweenScuebee est oseoeuewebeatceceseedesscs 104 | | 
| SECURITY TABLE | 105] | 
Waser ccdusuecsovecanacocauccuscecetaeeseuconses | 106] GLOBAL ALLOW MASK | 
. - 107| | 
110] | 
56” * |  acatetatatatatetstad ater abetatanebataatatebetananetataetanatananetananatanenetaneatanaaae | 
| encewcwccwweeennenwew ene ew ener ew een enoncncecee | | 111] AMSTAT ENRBLE WORD | #42 
§7| | | [pesbnraensaenasenseeccnensnntessecwessaseoere= i 
| pec ec eww nee enn nee wwenew nen meneennennecenencces | | 112] RESERVED | 
| PLABEL USERLOG (EXTERNAL) | es 
61| PLABEL USERLOG (INTERNAL) |  Kecececteteretasiatetatetanetatetetetatatetetadetbaheteniedetanataansbeteaeatentatatatee | 
seecedicddecncdsceassocessaeeen ecco enececeoeee=| 120] SYS PORT PROCESS PCB RELATIVE INDEX | 
62| PLABEL RECLOG (EXTERNAL) | | pom n wwe nee nnn nn nownenewn scene ween nenenwoenne | 
| eon en neem ween nnn eens enone wecnccewecccoce eoccee| 121} GLOBAL AFT DST NUMBER | 
63] PLABEL RECLOG (INTERNAL) | [essere tn se tera eseessecesesomenasnccensanssans 
[edesee ese ieh ise eenneace eeneseowaeee taeeeacte | 122] _‘ INITIAL/PROGEN CONN. DSEG NUMBER (CH. 16) | 
64} PLABEL RESTART (EXTERNAL) | | posse eeneseaasassacesessrnsssese-sa<esscessseH3 
| coweweerennsenennne Pececncnscoscncccuscasaccoss | 123] INITIAL SYSTEM STARTUP OPTION | 
65| PLABEL RESTART (INTERNAL) | | owen renece= ea ceeen ene cneeccewececw cco wccccowcre | 
| -ooenennne eecencccen een nwewrnweceoceecoenecnnes | 124] PORT’ MAX’ SER’ COUNTER | 
i PNBC LOW CORE BANK # (USER) ! ‘aE Pee sen easaassckssecsedsessecseesensSanseseeses= ! 
67| PMBC LOW CORE ADDRESS (USER) | OA CURRENTLY UNASSIGNED 
| eorcnennnnseennnnrnenaeweeeennewenenennenen=-- 
704 RESERVED FOR IRAGE | poco cere wenn cnn ecwceeecowscnesconnseosesncn= | SYSGLOB ExT. 
| | enn nnn nnn nnn meno nnn eno soe nnncnesewnnen|-=|--|--| | 130} Address Allocation OST | 2130 - 2144 
| 71 RESERVED FOR MEASIO | MIOCNT |* | | prerccce ree nwwncennnnmnncercnnnwncocacnsonewoce | HAVE BEEN 
| nee eee ewe ecw e erm eremweonewnenenenee|--[-- |--| | 131] IPC Platel | ALLOCATED TO 
72]  -UWORDER CACHE SEGNENT NUMBER | | a a a ae | NS TRANSPORT 
| commen nnn men ewwnwocen conocer enwewoocennncccocee | | 132| Multicast DST 
73) PLABEL 3270 (EXTERNAL) | | owen ncn rewcencecoccccccncene connwonecs eassene ~-| 
wcccccccoeccnenwennconcs seceeoweceocecorncnece=| | 133] PO OST | 
74| VERSION | | ni ee ae j 
eo cewonrenneccwnneneneceenecnsennwnenanessesoee | | 134] IP Update OST | 
75\ UPDATE | | | cone nn enn nn cence nnnnwnweswennnnocceccocenenne | 
| coreen enn ecnenecwconennnenne Serer mcernnneneneee i | 135| Node Nane OST | 
76| FIX | | _ Jew ee eee cecowenmcwwncnewnwewnccwcewcncccreowccen | 
| poem e meen nnn nnn mene nnew mown ccw see cewncconconce=| 136] Address Reference DST 
| at IP Identification 
6.23.00 6.23.00 
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Menory Layout Menory Layout 
SysGlob Extension (Cont.) ® AICCNT = NERSIOCOUNT (3 BITS) 
R&R BIT O = Enable HARORES AMSTAT cali 
i 140} St4 DST | MRESTRO’WORD DEFINITION 
| (0:1) = 1 = START’ UP BIT 
| 141} Flags uord | | (1:9) - (Not Used) 
|  _&. s[ptesernsssaessocaeasscseceeessaaaatensae sonen=| (10:1) = 18 nes Spooler Request 
| 142 Trigger DST (11:1) = 1 = Queue Entry in X0S 
| 143 Util. DST | HRESTRO DST-NUMBER - Contains the OST index for the 0S 
| Ameen ene emcee nrowwsce wwe cocccssccwcsconccce= | shared betueen Filter and GENNSG. 
| 144| FastPatn Sia i 
| I CL en | WS/X.25 OSTH(uord Z165) - OST # for the NPE V/E NS/X.25 
145| RESERVED FOR SPL | TRANSPORT link for INP’s. 
| | STARTUP OPTION(uord 2123) - Contains the last LORD/START 
baa PATH FLOW cption ae folleus: 
147| ANALYZER | © = WARMSTART 
| | 1 = COOLSTRRT 
150] | 2 = COLDLOAD(or COLDSTART) 
meme ene en wren ene nemnenenoencnnesecconeesescosce | 3 = UPORTE 
151] PC SUBSYSTEN INFO | 4 = RELOAD (ACCTS/NULL/SPRERD) 
wow e rte wwe e ewww nnn weceresnccwesnoersonecccesces | 5 = RELOAD (COMPACT) 
152] KODIAK M-CODE PERFORMANCE 6 = RELOAD (RESTORE) 
as MAESTRO’ WORD 
fa MAESTRO DST-NUNBER 
as <¢ SYSGLOB 2155 IS UNUSED >> 
as PSEUDO TERMINAL LINKAGE 
1§7| VIRTUAL TERMINAL LINKAGE 
160] DST # FOR NS/3000, %.25 PRODUCT STARTED = | 
161| PRD (Package Assenbly/Disassenbly) | 
162] NEC PROTECT VERSION LEVEL (VD4 and later) | 
163] NPE PRUDUCT UPDATE LEVEL (VD4 and later) | 
164| NPE FRODUCT FIX LEVEL (V04 and leter) | 
165| NS/X.25 DST W (VDE and later) 
166| PLRBEL OF TRPE RGMT CATALOG PROCEDURE | 
ae RESESVED FOR KNOUN VENDOR TABLE ! 
200| | 
[aesasneoheesonne seasceeeeancnseceeaaceesssses | 
6.23.00 6.23.00 
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Renory Layout 
SYSO8_Uords 


Systen tables may be accessed by using the LST/SST instructions. Pointers 
have the following fornat: 


60123 4 5 6 7 8 9 10 11 12 13 14 15 


Address is the whole word with “Bank” nasked out to 00000 


Systens that have MPE V/E nicrocode (all 6X systens, 4X systens with neu 
boards) can have a non-zero bank nunber. Systens running pre-fPE V/E 
macrocede can only use bank 0, therefore the pointer will lock like: 


6 7 8 9 10 11 12 13 14 15 


| ADDRESS 
SPOTS SS Ses EE he bh AE Eh Eb ES GD Ee EP GS UF Ep GH REE ED GE DD GD Oe WP OD Sh ee QO a | 
ob Word Definiti 
ADDRESS WANE FUNCTION 
08+55 BUSY - SYSDB relative pointer to BUSY TABLE for 
1/0 rescurces 
08+56 HEAD - SYSO8 relative pointer to table containing 
head pointers to I/0 resource queves 
08+57 TAIL - SYSOB relative pointer to table containing 
head pointers to tail of 1/0 resource queues 
08+60 SIO COUNT - Nunber of 1/0 Prograns currently executing 


08+72 POWER FAIL - O-no power fail 
1-systen disc recovery 
2-all other disc recovery 
3-all other devace recovery 
08+73 SYSUP - Systen 1s up and operable 
0B+74 CONSLOEV - Systen console logical device nunber 
DB+400 CPU NUMBER - Set uhen systen aborts 
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A flask n 


Worg Bit & 

UPPER LINIT->DEVICE COMMANDS 
ABORTIOB 0 13 13 
ALLOW 0 14 14 
| ALTSPOOLFILE 0 15 15 
ALTJOB 1 0 16 
BREAKJOB 1 1 17 
| DELETESPOOLFILE 1 2 18 
DISALLOW 1 3. «19 
JOBFENCE 1 4 2 
LINIT 1 § 21 
STOPSPOOL 1 6 22 
SUSPENDSPOOL 1 7 23 
OUTFENCE 1 8 24 
RECALL 1 9 2 
RESUNEJOS 1 10 26 
RESUMESPOOL 1 11 (27 
STREANS 1 12 28 
CONSOLE 4 13 29 
WARN 1 14% 
WELCOME 1 18 31 
MON 2 0 2 
NOFF 2 1 33 
VMOUNT 2 2 sw 
UNOUNT 2 3 3 
LOISROUNT 2 4 % 
ARJECONTROL 2 § 3 
JOBSECURITY 2 6 38 
DOWNLORD 2 7 #39 
AIOENABLE 2 8 4 
MICOISRELE 2 9 (41 
LOG 2 10 42 
FOREIGN 2 1°43 
}  IMFCONTROL 2 12 44 
SKONCON 2 13 45 
OPENQ 2 14 46 
SHUTO 2 15 47 
|  OISCRPS 3 0 48 

6.23.00 
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JOBSYNCH - Job synchronization via jobsynch (sysglobe121(8)) 


(13:1) = JOBSREADY - set by DEVREC & MORGUE (via procedure STARTDEVICE) 
indicating a ready job. This prevents UCOP fron 
going to a wast state when a job 18 just nade 
ready. 


(15:1) - OEVFREED - set by DEALLOCATE uhen device count goes to 0. 


NOTE: Both bits above used for synchronization of job-nade-ready or 
devicefreed when UCOP 1s running. 


(14:1) = JOBSWAITING- set by UCOP just before waiting if any job 1s 


waiting for list device. Signals OERLLOCATE to 
auake UCOP uhen a device is freed. 


Allow Mask Fornat 





The Allow nask for NPE V is expanded to six words. There is a mask in each 
user’s JIT and in the SYSGLOB area. The Allow nask contains enough bits for 
a one-to-one correspondence to every present OPERATOR type connand, or any 
future OPERATOR conmand. When a user is ALLOWed any OPERATOR connand or 
ASSOCIATEd to a device (which will use OPERATOR type connands) then the 
corresponding bit(s) in the nask in that user’s JIT for that connand is set. 
If the ALLOW or ASSOCIATE was done cn a global ecale, then the bit(s) in the 
nask of the SYSGLOB area is/are updated. 


The following EQUATEs define the nask bit for each cperator connand. 
The firet set of commands define the operator connands dealing with devices. 
liken adding a new connand to this set of EQUATEs, be sure to add a 


corresponding nove etatenent in LOGINRGE, even if the connand wall not be 
logged. 


ord Bit Wt 
RBORTIO 0 o oO 
ACCEPT 0 1 1 
DOWN 0 2 2 
GIVE 0 3 3 
HERDOFF 0 4 4 
HERDON 0 § § 
REFUSE 0 6 6 
REPLY 0 7 7 
STRRTSPCOL 0 8 68 
TRKE 0 ; 
UP 0 10 10 
MPLINE 0 1 «11 
DSCONTROL 0 12 12 
6.23.00 
1- 22 
Renory Laycut 
Logging Related Locations 
SYSO8 


0123 4 5 6 7 8 9 10 11 12 13 14 15 
172|-=|-=|==|-=1-=1-=[-=-L=-1--1-=1--l--1--I--1--1-=| 
or [STATE| OST @ { 


173|-----|--- 








STATE = 0 if respective buffer enpty 
1 if respective buffer is current 
2 if respective buffer is full 


ELAGM 


345 6 7 8 9 10 11 12 13 14 15 
J=-[-=J==f-=1-=1-=]-=1--1--1-=1=|==|-=|===1-=1=- 


176| | SF HF [BUF |SL{SOI 


SF = 1 if soft failure 
WF = 1 if hard failure 
BUF = 0 if current log buffer ie buffer 0 
2 1 if current log buffer is buffer 1 
SL = 1 to indicate a suitch in log buffers (fron 0 to 1 or fron 1 to 0) 
$0 = 1 to indicate shutdoun in progrese 
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Renory Layout 


x0 | STOP BITS REPRESENTING WHICH 
| PROCESSES 10 STOP ON “SHUTDOWN” 


| 

| 

| 

! # PROCESS ENTRIES ! 

| | 

! 1ST PROCESS ENTRY 

| 2ND PROCESS ENTRY | 

| eonennmnnnweeneeennn en nnnn nen eece nn ennn econ nnn= 

| : | 

| . | 

| . | 

: | ! 
le LAST PROCESS ENTRY | 

Entry Fornat 


01234 5§ 6 7 8 910 11 12 13 14 15 
eg ed pod eS Pe oo eb 
| PROCESS PIN # | STOP BIT # | 


Preassiqned Entries 


ENTRY @ PROCESS STOP BIT # 
1 devrec 2 
2 ucop 0 
3 log 1 
6.23.00 
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Bank 0 
| --------------nnonennnnnnnnnn nna | 
[ LOW CORE MEMORY | 





<--| 

|(Only on 6x/70 if 
o---|Privilege flode Bounds 
| Checking 1s enabled. ) 


| FIRMWARE AREA | 


SSO SOS OSC OS208 22882828 S2ES2SS8SOSRSESOOSRCO 


| SYSGLOB EXTENSION 


| DST/CST/CSTX 





| SYSTEM GLOBAL AREA 

















| rcs 

| ge a for 6x/70 if 
| enne nn nnn nnenennn nnn nenncnennnnen= [Privilege Mode Bounds 
| ILT/OIT | Checking is enabled.) 
oe | 
comes 
estou 
| SERORY MEASURENENT INFO | 
| van en — 
| 


JOB PROCESS COUNT 





»PCB 
| »SUAP TABLE (SLL) | 
>SPECIAL REQUEST TRBLE | 
| >JO8 CUTOFF TABLE | 
| >TIMER REQUEST LIST | 
| >SYSTEN BUFFERS | 
| >LPOT 
| >T0Q | 
 Fecaetatadatetettetatiateteteenateape anetanetetanetanaal | 
| >SIR \ 
Ee ES | 
6.23.00 
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Initial Nenory Allocation 


This section 18 a description of the nethod used by INITIAL to allocate 
menory for NPE tables and code segnents in MPE V/E. All menory allocated by 
INITIAL 18 permanently allocated. All non-core resident code and data is put 
on disc before exiting INITIAL. 


At the nost basic level INITIAL will try to build menory to look exactly as 
diaaranned below. There are, however, several ways in uhich to deviate fron 
this -‘-ucture. Before goino into the sources of these deviations, it 1s 
necessary to point out uhi~ vortions of nenory are used by INITIAL during 
the restart and, therefore, cannot be used by MPE until INITIAL has finished. 


Before INITIAL begins to allocate any nenory space, it relocates its core 
resident code, 1ts code segnent swapping area and its stack to the highest 
configured nenory space. Additionally, it uses the last 2326 words of bank 0 
on series 4X machines for its I/0 buffer area and tenporary code segnent 
table. After INITIAL has bualt all of core resident MPE (tables and code), 
at builds the disc resident NPE tables. Since sone of the disc resident 
tables may be too large to be bualt in INITIAL’s stack, these tables are 
built in unused nenory space. Therefore, in addition to the menory space 
required for INITIAL'’s code, INITIAL'’s stack and core resident APE, there 
nust be enough space left in which to buald the largest of the disc resident 
tables. 


For Series 6X machines with the APE V/E firmware, INITIAL will build the 
tables with ">" signs by then out of Bank 0 if necessary. for all other 
tables, INITIAL will essentially build menory in the order shoun below. 

There nay be an unused fragnent of nenory betueen the DRTs and the systen 
global area which INITIAL will fill with the snaller tables. Neither the 
tables narked with an asterisk nor the code segnents will ever be put in this 
area. NOTE: INITIAL will build all tables on 32-word boundaries. 


If the systen being built by INITIAL is configured with 128K words or 160K 
uords of memory then INITIAL’s stack will be in bank 1 (the code also on a 
128K word nenory size). If INITIAL is occupying part of bank 1 and the space 
is needed for a core resident MPE code segnent or to build a disc resident 
table then INITIAL will prant the error message "ERROR #350 OUT OF NENORY". 


Except for the exceptions stated above, for every allocation of nenory 
INITIAL will first try to allocate any remaining space between the DRTs and 
SYSOB. It will then try the next available space in bank 0, then the next 
available space in bank 1. If it were necessary it could continue searching 
until all all banks were checked for available space. 


Innediately before exiting INITIAL, INITIAL lays doun all the nenory region 
headers and trailers as shown below. For any one bank of nenory there will 
only be one block of core resident NPE, regardless of its contents. The only 
block of core resident MPE that does not have a reserved region global header 
is in bank 0. It does have the reserved region global trailer though. 

Before placing any code outside bank 0 the First 24 words of every bank 
(except bank 0) is reserved for the region global header. 


6.23.00 
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Nenory Layout 
ank 0 nt 

| ------nwnnnnn n-ne noe eenneeoenene=- | 
! TON TABLE | 
| | 
| COPE RESIDENT CST°S | 
| IN GADER | 
| | 
| RESERVED REGION GLOBAL | 
| TRAILER { 
wWiussdenscabeesdactadaeckcees wwen| 
| AVAILAGLE REGION GLOBAL | 
| HERDER 
 etetetatacaetatadateeateatatanecatateratertanetanateaieatae | 
| | 
| | 
: | 
AVRILABLE RENORY | 
| | 
| | 
| | 
| 


| 
| AVAILABLE REGION GLOBAL | 
TRAILER | 


NOTE: The > neans these tables can nove out of Bank 0 if necessary. 
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flenory Layout 


| 

| 

| 

| 

| 

CORE RESIDENT CST'S AND | 
TABLES MARKED WITH “>” = | 
! 

| 

| 

| 

| 

| 

| 

| 


| 

| 

| 

| 

| THAT DION’T FIT IN 
| BANK 0 

| 

| 
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Flenory Ranagenent Tables 
Pointers and DST #’s of Seqnent 7 nponen 
i. OST 


Z 2 absolute address of entry 0 of the DST. 
11002 sysbase relative index of entry 0 of DST. 
DST nunber 2 is the OST Table OST #. 


ii. CST 


Z 0 absolute address of entry 0 of Systen SL. 
21001 sysbase relative index of entry 0 of Systen SL. 
21032 displacenent fron DST base of entry O of Systen SL (i.e., 
@CST(last) - @DST(O) 2 OFS ). 
] OST nunber 1 is the CST Table DST @. 


iii. CSTX 
Z 1 absolute address of entry 0 of current pregran. 
21033 displacenent fron DST base to first CSTX entry SL. 
DST nunber 4 is the CSTX Table OST @. 

iv. CSTBLK 


21051 sysbase relative index of CST Block Table. 
| OST nunber 35 (243) is CSTBLK’s DST @. 


ES ES A AS AS SS A 


Renory Managenent Tables 


CHAPTER 2 MEMORY ARNAGENENT TABLES 


Seqnent Table Structure 


The current location and state of each data segnent snd loaded code segnent 
is maintained in the Segnent Table. This table is partitioned into three 
separate tables as shown belew. The partitions are based on the segnent 
classes: a segnent 15 a data segnent, a segnent 18 a syster “' segnent, or a 
segnent 1s part of a progran. The structure and format of each partition is 
described in the following. 


Overall ST Structure 


(%2), (21002) #SYSBASE -------- > — | eenweee | 


(20), (21001 )#SYSBRSE -------- ae 


|LOADED | 
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Standard Obiect Identifier Fornat 


123 4 6 7 8 9 10 11 12 13 14 15 
Jon |--|-=]==]--[-=[--1-= l= f--1-=1--1-=1-=1-=1-+| 


TYPE | CST BLOCK - RELATIVE INDEX | 
| OBJECT NUNBER | 


| SSO 9S 6 BOOS 8 OS O48804 £88 8994084444 22284608 22222282800 | 


CBJIOENTIFIER(O).(0:4) = TYPE 
= 0 Object is a Data segnent 
#1 Object is an SL segnent 
= 2 Object is a Progran segnent 
# 3 Object is a Cache Donain 


OBJIDENTIFIER(O). (4:12) = CST BLOCK Table index to list of CST segnents 


OBJIDENTIFIER(1).(0:16) * Nunber field: 
DST, CST, CSTX, or COT nunber 


T Entry Forna 


45 6 7 8 9 10 tf 12 13 14 15 





WORD 0} # CONFIGURED ENTRIES 

nm Ana 
mee Wao 
UORD 3] TRBLE RELATIVE INDEX TO FIRST FREE ENTRY 


TABLE RELATIVE INDEX TO FIRST FREE ENTRY 
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Renory Managenent Tables 
ST General Entry Fornat 


Case (i) DST Entry for a Present Data Segnent 


01 34 5 6 7 8 9 10 11 12 13 14 15 
J--]--]--}--f--}--1--}-- foe lee lel l--l-- lee -- 
WORD ol jo [rR | SIZE/4 IFIRNINFO 
WORD 1/0 IR [I IS IM JF IS IC Iu | 
ic jo jn it jo judy 10 {0 | VMALLOC [FLAGS 
Vic iz jk lo iris rt | | 
| ;rttt eet edt 
WORD 2| SANK | MMBRNK 


WORD 3] BASE innBAst 


Case (ii) OST Entry for an Rbsent Data Segnent 


01234 5 6 7 8 9 1011 12 13 14 15 


word ofA lo JR | ——‘ SIZE/4 [FIRNTAFO 
uORD 1/0 IR IZ IS IN IF IS iC tw I | 
ic lo In it fo [wily lo (0 | VRALLOC [FLAGS 
WiC IZ (KO WT IS IRI I | 
| ; i) ot ws te | | 
word 2] WEV 8 | HODA IHoDR 
woRD i LOA lupe 
6.23.00 
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Refer to the Logical Segnent Table Format in Chapter 11 for nore 
infornation on XCST. 


T Entry Fi ri 
A= 1 = segnent absent 
Ns 1 2 segnent privileged 
R = 1 = segnent has been referenced 
T © 1 © segnent is being traced 
DCV = 1 = diese copy is valid 
STK © 1 = eegnent is a stack 
gs 


MOD = 1 = a segnent change in size or location is requested 
FUIP = 1 = a forced urite of this segnent is in progress 
VIPRGECNT = @ of virtual nenory pages allocated to this segnent 


ROC = 1 = segnent is recoverable overlay candidate 
IMI = 1 = segnent is in motion in 
SYS s 1 ® segnent is a systen segnent 
CORE = 1 = segnent is core resident 
WD = 1 = write disabled 
CSTBLK Format 


345 6 7 8 9 10 11 12 13 14 15 
|--|--|-=}--1--1--|--1--1-=|--1-=1--1-=1--1--1-=| 


CSTBLK O| —- NUMBER OF ENTRIES IN CSTBLK TABLE 








2082S 80282080008 2eee2e20e0n SOO OS PSO OD | 
1] ENTRY NUMBER 1 
a ENTRY NUNBER 2 | 
4 ENTRY NUNBER 3 | 
eccneccececccncne nncwencnnccnnecsceeneene------| 
nl ENTRY NUMBER n | 


The table entries sre initialized to -1 to denote an unassigned entry. Uhen 
an entry is assigned, its contents is replaced with a DST relative address 
uhich points to the header entry of the code segnent list (see the CST 
EXTENSION table fornat for nore infornation). 
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CST _Entry Fornats 


ST General Entry Forna 


Case (i) CST Entry for a Present SL Segnent or CSTX Segnent 


012345 67 8 91011 12 13 14 15 
Tes feed aed fet ed ore od ed od odd Cel 
WORD OJA IN IR IT | SIZE/4 | FIRMINFO 
word 1] IRIZT! It | Js {c | | 
loin} t ft iy lof |FLAGS 
) fc iri | t Ys (Rt | 
| ;itdett ved | 
WORD 2| SANK [ NNBANK 
WORD 3] BASE | MMASE 


| 08S OS OS4 CO OC 8 O88 2 28E0E88E08 298 248 E8 42 2ESGSE2TSOB8E8°0 


CASE (ii) CST Entry For An Rbsent Segnent SL or CSTX Segnent 


123 4 65 6 7 8 91011 12 13 14 15 
|--|--|---- leo feel oe} -- ben l-- lee --1--}--l--1-- 
WORD O|R [MN IR IT | |FIRRINEO 
woro 1] IRIT{ { | IS ic | { 
| jojmt | f J¥ Jo} |FLAGS 
{ tC izt ¢ | IS WRI | 
pitt dt tet 
WORD 2| LEV @ KOOA {HODR 
WORD ‘| LOOA | LOCA 
Case (iii) OST/CST Free Entry 
weacccccceccnewnwcncesesceccnnecsceccecccencces | 
{ 2100000 | 


6.23.00 
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CST _EXTENSTON and the CSTXAAP 


Since prograns can be dynamically loaded and unloaded, the segnent table nust 
be kept packed or fragnentation would occur. Thus, the bleck of ST entries 
for a progran segnent begins at an ST entry number that changes if a progran 
which was loaded before it gets unloaded. To manage this dynamic structure, 
an auxiliary structure, the CSTXAAP is used. The CSTXARP is a contiguous 
block of entries inside the CST EXTENSION. It contains a header entry 
describing the block of entries and a group of CST entries describing each of 
the progran code segnents. The start of the CSTXMAP is pointed to by an 
entry (CSTXEIX) fron the CST BLOCK (CSTBLK) table. 


Entry Fornat - CSTXMAP 


123 4 5 6 7? 8 9 10 11 12 13 14 15 


a ed bo bd Bd Pd Pd cd ge 
HEADER 0] # OF CODE SEGMENT ENTRIES OF THIS BLOCK | 


1} 2125252 


rd NUMBER OF USERS SHARING THIS SLOCK 














CODE SEG 141A |P IR IT | SIZE/4 (WORDS) 








2} BANK/BRSE RODRESS OF 
CODE seGnen IN RENORY 
3| LOEV# HODA/LODA ADDRESS 
lI eect SEGHENT OW OISC | 
CODE SEG 2008 {P {R |T | SIZE/4 (WORDS) ! 
DIR IIIS In |F IS Ic Iw | 
11C (0 IN {7 10 Ju IY 16 JO | VAALLOC 
Vic JI IK IOIT iS Rd | 
tt td wl edd 


CODE SEGMENT IN MEMORY 
OR 


LSEva YODA/LODR RODRESS 
OF CODE SEGMENT ON DISC 


| 
| 
| 
| 
2" BANK/BRSE ADDRESS OF 
| 
| 
I 
| 
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n Fornat - CSTXRAP nt. 


~a 1 


i SIZE/4 (WORDS) 


BANK/BASE ADORESS OF 
CODE SEGHENT IN RENORY 


| 
| 
| OR 
| LOEV# HODA/LODA ADDRESS 
l 


OF COOE SEGHENT ON DISC 


The value of CSTXEIX is established when a CST extension block is allocated. 
This index into the array CSTBLK 18 maintained in the PCB of each process 


sharing the block. 
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Fix T a 
OCTAL CECINAL 
s\ bincctony ace et 
“ he de 
o7| aSuRPTADLE (SLL) 8 
30| JOB PROCESS CouNT ——=s«sf2 
ut 300 MasTeh TOE es 
sel ee wae 
33) LOG me 
ot nepur Tauenation zt 
| TABLE | 
35) VOLUN TABLE \29 
al memoue tae Lf 
ul ie ord 
ol une euFFER2 132 
al oe BO ‘33 
42| aSSUCIATE TABLE I> 
al ste 
ual e305 cuir TLE 3S 
Pe gee aan 
6 *specTAL REO TLE 8 
; inal oie eee AS 


47] VIRTUAL DISC SPACE 
| MANAGENENT TABLE 


SOOO O OS OCSSSOCS SESE 6 4 BOSSESBOEOOOS 


50| DEVICE CLASS TABLE ti 


4 


§1| RESERVED KERNEL 


on 





® Can be moved out of BANK O if necessary. 
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TABLE WANE 


RIN 
SUAPTRE 
JPCNT 
SHAT 


vod 
LOGTRS 


RIT 
VTRS 
STO? 


LIOTRB 


CSTBLK 
JCuT 
SJIT 
SRT 


VOSATRS 
DEVCLASS 


flenory flanagenent Tables 


Fixed DST Entry Assignnents 


OCTAL oa 
0| \0 
|------s-eennnenenennenennnnne 
y CST : 
2] DST ‘i 
| wee we ce we cewe one eww eseescencce 
3} *PCB ‘i 
| See mewwccece ce cc cenwceceecoece 
3 CSTX |4 
5| SYSTEM SLOBRL AREA (5 
| ee ee rT rr 
. CORE 6 
7| Ics |? 
| SSYSTEN BUFFERS . 
my UCOP REQUEST QUEUE 4 
12| PROCESS-PROCESS 110 
| COMMUNICATION TABLE | 
13] *1/0 QUEUE \11 
14| TERMINAL BUFFERS e 
15| ALOGICAL-PHYSICAL 113 
| DEVICE TABLE 
16] LOGICAL DEVICE {14 
| TABLE | 


| 
17| DRIVER LINKAGE TRBLE = 15 


21| SSECONDARY ASG TABLE |17 


22| *LORDER SEGMENT TRBLE [18 


| 
23] TIMER REQUEST LIST \19 


| 
“| DIRECTORY (20 


& Can be noved cut of BANK O if necessary. 
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OCTAL DECIMAL 
al arid 
3, MIME a] 
ac ma le 


| 
55| INPUT DEVICE DIRECT j45 


56| QUTPUT DEVICE DIRECT \46 


57| WELCOME MESSAGE #1 \47 
60| WELCOME MESSAGE @2 ag 
61] CS DATA SEGHENT {49 


62| PROCESS-J08 150 
| CROSS REFERENCE | 


sid RESERVED KERNEL 155 
70| DISC REQUEST TRELE 156 
71 FSG HARBCR TABLE |S? 


Se 2828S OOS 82 B22 SECs COB STETAEF® 


73| PMEASURENENT INFO TREBLE [59 


74| FIRST FEEE UST |60 


* Can be moved cut of GANK 0 if necessary. 
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CST 
DST 
PCB 
CSTX 
SYS 
CORE 
Ics 
SBUF 
UCRO 





PPCOA 
10g 
TBUF 


LPOT 


LT 

DLT 

BUSY, HERD, TRAIL 
SECHSGTAB 

LST 

TRL 

DOS 





Henory Managenent Tables 


TABLE NARE 
Tit 

SIR 

FRAVT 

100 

005 
LOGONDSTN1 
LOGONDSTN2Z 
CSTRB 
PJXREF 


SYSJDT 
CILOGOST 
IVTAB 
PYUSER 


DISCREQTAS 
ASGHARBTRB 
PRIMNSGTRE 
NEASINFOTAB 














Renory Ranagenent Tables 


Suap_Tables 


The SUAPTAD is a core resident nenory nanagenent table used to keep track of 
the locality lists of the conpeting processes. The PCB entry for a process 
has a SUAPTRD relative pointer to the header entry of the process. 


SURPTAB DST# = 23 (Z27) 
21004 Systen table pointer to SUAPTAB entry 0. 


NOTE: The nunber of entries configured will be 3 
greater than the nunber configured via 
SYSDUMP. (Entry 0 consunes 3 entries). 


SUAPTAB Entry 0 Fornat 


octfaL © 12 3 4 5 6 7 8 9 10 11 12 13 14 15 DECIAAL 
--|-=|-=|--|--1--]--1-=1==1-=1-=1-=f-=1-= 1-1 -- 


0] # ENTRIES CONFIGURED 
1| ENTRY SIZE (6) \1 


2] # AVAILABLE ENTRIES j2 


80S OS8 OC 6 8808 SS 242 CSE OSE48 4 228 2OSSESE COBSHSSZASTSSCOASSBO 


3{ TABLE RELATIVE INDEX OF FIRST FREE ENTRY 13 


4} TABLE RELATIVE INDEX OF LAST FREE ENTRY 4 


| HIGH UATER MARK Is 
6| # PRIMARY ENTRIES (0) 6 
7 HEAD OF IMPEDEO QUEUE (PCB RELATIVE) ? 
10] TRIL OF IMPEDED QUEUE (PCB RELATIVE) 18 
11| # CURRENTLY INPEDED PROCESSES [$ 
12| MAX # OF IMPEDED PROCESSES 10 
‘31 CUMULATIVE # OF INPEDED PROCESSES \41 
14| . 142 
| . | 
| { 
| | 
21| |17 
| prema nn nn nnn wenn nnn wenn enn nnn cnc ownnnnnnwnccen=| 
6.23.00 
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Nenory Managenent Tables 
nent j ists 


The systen naintains for each process a segnent locality list (SLL) of the 
segnents belonging to that process’ current working set. The process’ SLL 
consists of a header and a list of entries. The header and list entries are 
taken fron the SURPTAB. 


A process’ SLL is located via the process’ PCB entry. PCB01 contains the SLL 
relative index of the process’ SLL header. 


SUAPTAB 
|onocew men ne nnnnenewwerenncennnnn| 
l : | 
| ‘ | 
| 3 | 
PCBO1-->| SLLHERDER | 
fro} | 
| Jeceeeenn= seatataatatatatetaietaieneiataneeenataee | 
; | : f 
1 | . | 
: 3 | 
\->| FIRST SLL ENTRY t 
{--| | 
| [renee nenenec enon nme ceeeeoonece --| 
; | . | 
it . | 
1 | . | 
J [renecnnneseeeeroneeenee oanaietate | 
\->1 NEXT SLL ENTRY | 
{--| | 
| [recee nro ee ern nne nee eee nee ronnnee | 
i | . | 
| | . | 
v | ° I 
| 
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SUAPTAB Unassiqned Entry Fornat 


OLrAL O 1 2 «~«<93 ~ «4 6 7 8 § 10 11 12 13 14 15 DECIMAL 
ed dd ee ed ee 


0| 
| 
14 TABLE RELATIVE INDEX OF NEXT FREE ENTRY = |1 


Z| TAALE RELATIVE INDEX OF PREV FREE ENTRY le 


3| ) 13 
Jae cos 2 renew enwewnn nnn nme cewnenenenewennnee | 
4} a \4 
5| 0 15 


An assigned entry in the SUAPTAB is a process’ SLL header or a menber of a 
process’ SLL. These formats are nou described. 


Notes: 
Word 0: In an unused entry only has 2100000 if this entry uas 
previously for a OST or CST, otherwise it is 0. 
Word 2: The PREVIOUS pointers are not valid. MPE does not maintain 
(or use) then. Only NEXT pointers are valid. 

Words 3-5: Rre not zeroed out when a used entry becones free, but 
will still contain the old data. They are only zero’d 
uhen the table is first initialized. 

6.23.00 
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nen alit Header Forna 
0 1 34 5 6 7 8 9 10 11 12 13 14 15 
Fated Sad Gated Datel ated Rated Gated Ketel Se Stel ad Gated el Sel tel | 
| IS WHIT IP IS IS] | 
} (iA IN GAIT (et | | 
Oo} IRIS iT (RMIT! | TOCHT | SCHEDTOIONSG 
| IE IM IL It It PY | 
| (WIE Oirios | | | 
| L mic iwivd Fo 
1] THREAD TO FIRST SLL ENTRY [FaRstIMe 
2| 
3| SLL REL ADDRESS OF OBJECT TO BE | MENREQINX 
| BROUGHT IN 
4| @ OF SEGHENT LOCALITY LIST ENTRIES | SEGCOUNT 
OF PROCESS 
5| | 


| 2 COS OS 82 2888 OS4OE8S OSES OS98 8448 6 O822EO8E8SEEE2EE0E28022 | 


SLL(SLLHEADINK+O) 
- (1:1) SUREQ, Swap Required Flag 
-(2:1) HASMEN, Has Nenory Flag 
-(3:1) INTLOC, Inatialize locality list to nininun 
- (4:1) PARTIN, Process partially swapped in 
-(5:1) STRTOV, Start suap over flag 
- (6:1) SWIP, Swap In Progress Flag 
(8:8) IOCNT, Nunber of READ 1/0 conpletions until 
SUAPIN is completed and the process 
is able to be auvakened 
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Seqnent Locality List (SLL) Entry Fornat 
: f 3 4 ,, f 7 8 910 a 13 14 4§ 
|-- asaleae]ans/[aeiaee]| ee] ee ee ealealealeeni oo ij eefea 
PCB RELATIVE INDEX OF THE NEXT |NEXTINPPIN 
| WAITING PIN 
| ancennerncaewennsanonnnecennnnnecsrenssennsenes 
1| SLL REL ADDRESS TO THE NEXT ENTRY |NEXTINX 
| IN THE LIST 
| nocennnnenennnenenceeneeronnscenceresnnneenene- 
2| SLL REL ADOR TO THE PREVIOUS ENTRY | PREVINX 
| IN THE LIS ! 
| pocenennnnnnoeenennnencnnannenenecnnenanenecnne 
OBJECT (SLL OBJDESC 
j 4] IDENTIFIER [SLL° OBJNUN 


L 10 | 
K IE | 
R ic | PREFETCH |SLL’ FLAGS 
E Ic | COUNT 
QIN | 
it | 


SLL(SLLINK*#O) NEXTINPPIN, next nake present deferred queue 
PCB Index 


SLU(SLLINNe1) NEXTINK, next SLL entry 

SLL(SLLINX¢2) PREVINX, previous SLL entry 

SLL(SLLINX#3) SLL'OBJDESC, tet word of object identifier* 
SLL(SLLINX+4) SLL’OBJNUN, 2nd word of object identifier* 


SLL(SLLINK+S) 

1) MAPSEG, Process’ CST napping segnent (LSTT) 

1) STK, Process’ stack entry 

1) OISCIOSEG, Dise 1/0 pending on this segnent 

1) LOCKED, Segnent locked in nenory 

1) BLKLK, Request for blocked lock 

31) FROZE, Segnent frozen in nenory 

1) SLLIAI, Process queued for this segnent 

1) TOSS, Toss this entry 

1) FRZREQ, Request segnent to be frozen 

1) LKREQ, Request to lock segnent in nenory 

1) DECCNTFLAG, Decrenent # 1/0 conpletion before 
auake flag 

.(11:5) PREFETCHCOUNT, Nunber of prefetch segnent 

request counter 


6. 23.00 
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T Ent Forn 
| noeeennwennenennowceenne= wateecceecs 
} ® ENTRIES CONFIGURED ! 
1| ENTRY SIZE (6) | 
2| @ AVAILABLE ENTRIES | 


SOS O 00 O48 OO 288 C2 © 088 2EH EES SOS8S BOSE | 


3| TABLE REL. INDEX OF FIRST 
| FREE ENTRY 


4| TRBLE REL. INDEX OF LAST 
| FREE ENTRY 


[--e= SES OSS 0228 224 22SSSSES6E8 Ree Seen 


5| HIGH UATER MARK 


] 2898 S888 8 OOS SCSE SS 64 OSS SSSBSSSOFOSHSOS 


6| ® PRIMARY ENTRIES 


7| HERD OF IMPEDEO QUEUE | 

| (PCB REL. ) j 

| 10] TAIL OF INPEDED QUEUE | 
B REL. 

| 11] @ CURRENTLY INPEDED PROCESSES | 
| 12| W MAXIMUM INPEDED PROCESSES =| 
| 13) CUNULATIVE # OF INPECED | 
| PROCESSES 

| 14| | 
| | 

| | 

| | 

| | 

| 21] | 
| eonnenon nnn nenne = 222 - enn n neo eee non | 

6.23.00 
2- 18 


. won arelt. D 


Menory Managenent Tables 


NOTE: The Suap Table will be configured with at least tuice the 
nunber of configured PC6s. 


® See Standard Object Identifier Fornat for nore information. 
R Tab 
Used for passing data segnent size change info and for keeping a list of 


devices waiting for a segnent to arrive in menory. 


21042 - SRT relative index to entry # 0 
11043 - SRT relatave index to the head of the queve 


NOTE: The nunber of entries configured will be 3 greater 


than the nunber configured via SYSDUNP. (Entry #0 
consunes 3 entries). 
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The following entry fornat is for data segnent size/location modifications: 


| F808 OSS 4 OSS C262 © 8 OSS OS8SHSSSSOESESE >: 
0| NEXT ENTRY FOR DATA SEGHENTS = | 


1| OBJECT 

Ae IDENTIFIER "| 
al "gu ont SENT SLE 
i eeciaaca 
Sm 


8988899889888 SOGS90 8 O98O2882S8SSESSS9SSSER88 | 


The follouing is the fornat for devices uaiting on a segnent: (The region 
header for the segnent contains an SRT relative index to this entry. If nore 
that § devices are waiting on this segnent, another entry uill be linked to 
this entry.) 


0] NEXT ENTRY OF QUEUED DEVS | 
| ON SEG | 


| 08806 O8 06 OO 8O98O882E8E8 99202228 SSH T8888 





| IOQINK | 
ac 
ge 
ee ee 
eT en 





NOTE: The nunbder of prinary configured entries will be equal to the total 
nunber of LDWEVs configured. The nunber of secondary entries will be 
configured to be at least the sane as the nunber of PC8s configured. 
Data segnent change entries are secondary type, while devices queued 
entries will be pranary entries. 
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Nenory Ranagenent Tables 


The following is the format for a request to have the data segnent noved: 


0| THREAD TO NEXT ENTRY | 


|anennennenncnennnnnnenenecernnenenncnennensaas | 
1| | 


ZI | 


fain flex Region Headers and Trai 


flain nenory is partitioned into regions. Each region is in one of four 
states: available, reserved, assigned, or cached. 


An available region is available for consumption by the free space allocation 
nechanisn. fn available region consists of neighboring subregions, each of 
uhich 18 either a hole or an overlay candidate. An available region is 
linked anto the available region list. 


A reserved region is a nain menory region uhich is in the transition state 
fron available to assigned. A reserved region has been cleaned, and there is 
a pending disc read of a segnent into the region. 


Assigned regions are cecupied by present segnents. Available and reserved 
regions consist of one or nore adjacent subregions. Region headers and 
trailers are partitioned into global and local conponents. The global regicn 
header/trailer is only valid for the first/last subregion in regions 
consisting of more than one subregion. 


The region headers and trailers of available, reserved, and assigned regions 
contain the state and control information pertaining to the current or 
planned contents of the region. 


Cache donains are another forn of assigned regions and are designated as such 
in the subregion header. If the cache donain is “mapped” (1/0 pending 
against 1t) then the object identifier will have a non-zero value in the 
second word of the segnent identifier field. If the second word of the 
segnent identifier field 18 zero, then this region 18 4 cache donain that is 
unnapped. (Refer to Chapter 23 for further information regarding Disc 
Caching. ) 
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Subreqion Header (Available Regions) 


1234 5 6 7 8 910 11 12 13 14 15 


|RB-217| SUBREGION ASSIGNMENT STATE {SAS 
jc JR IR IR IR {7 
ja 1€ 10 IE {E | 9 | 
ic jf IC IF IF is | 
: 4 | 42 43 | 7 
|RB-Z16 SUBREGION SIZE IN PAGES {$s 
{RB-Z15!V | SUBREGION DISPLACEMENT IN MAIN NEN. PAGES |S 
Je- ewe cece se ce een oe ees eee eee eenes eoeeennewesosoe 
Lean URITE REOVEST POINTER juReaP 
(RB-233| OBSECT pees 
| IDENTIFIER 
oe 
kde | 
| eel LDEV | HODA {HODA 
| sc LOW GROER OISC ADORESS ! LOOR 
| RB-25| 
| R8-24] 
| 8-23] 
| RB-22] 
| RB-21| / 
ewww ne nnn ence owen een enon non eenenwoceeneoneees --| 
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Renory Nanagenent Tables 


Global Region Trailer 


1234 5 6 7 8 91011 12 13 14 15 


eee 
|RB-233} TRAILER SUBREGION SIZE (PAGES) |PTSS 
|RO-Z32 TRAILER REGION STATE JPTRAS 


| 
| | 
tat i | 
|RB-231 | TRAILER REGION SIZE (PAGES) JPTRS 


“nan 
amn 
<> 
=ro 


| Trailer length = 4 


Global Reaion Header (Available Regions 


01234 85 6 7 8 910 11 12 13 14 15 

ed ees ed ped pes end ed ed ed ee be a 
'RB-Z3| REGION ASSIGNHENT STATE [RAS 

fa iR IA IC IS JL UF AL It | in | 

ISIE lV JL ic 1K 12 10 IS | II | 

isis} IN} IP IN IF IT | IP | 

ri | Did t tint | | 

ee ae. | 
|RB-Z27| REGION SIZE IN PAGES IRS 

icees 

na-225| | 
ee PREVIOUS LINK (ADDRESS OF PL FIELD i 

! OF PREVIOUS AVAILABLE REGION) 
ra NEXT LINK (AODRESS OF NL FIELD) NL 

IN NEXT AVAILABLE REGION) 

eon | 


| Header length = 24 (230) 
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Global Region Header (Reserved Regions) 


0123 4 5 6 7 8 910 11 12 13 14 15 


--|--|--|--|----|--1--1--]--f--f--1--1--l--t--] 


89S SS8 CO @ © 6 OO OS 6 OSS BO 24S 6 BOSE 46 SE SSS 22 STERHOAOOTO 


| 
|RB-%30] REGION ASSIGNMENT STATE JRAS 

A IR JA IC IS WLIF IT (LIM | 18 | 

IS 1€ VfL IT (0 12 10 1S JAI ju ft 

IS IS IA [E (Z |C IN IF IT IP I jn | 

Ts IWATE KI (ZIT 1 1 \I | 

ee aie a 
|RO-227| REGION SIZE IN PAGES Ii 
ne aes ON GOING I/0 COUKT ! 10CNT 
|RB-Z25| INITIATION MESSAGE {INITASG 

IT (E 10 JQ IZ JE 1G IM IR Im | in | 

jO Ix IN JU IN [xX JA TS JE IS | Is j 

1G 17 1G [E |C IP IR {G IL 1G | (G | 

|G (D {0 |S JO IR 18 Ja IP JS | iv | 

{L JZ |Z 1E IR TE JA 16 IA IT | ja | 

J€ IS IN JG jm [Q 1G 10 IG [A | {ut 

} IA IG IR IS lu 1E IR IE IR | \I | 

{ WWE, Itt Ith |o | 

HE eee) of 
ee ORQ REL ENTRY RDORESS aries 
|RB-X23| CONPLETIGN MESSAGE |COMPYSG 

IT In JB (S II in | jn | 

jo [0 iL {C 10 IS | is | 

ig IV IK ju ju iG | IG | 

IG JE [0 JE JA 1° | lv | 

JL IR JL (0 iK 18 | ja | 

j€ 1€ IK Im JE IO | ju | 

} Wt ist RI II | 

1; i ms itt 10 ! 


|RB-X22| MAKE PRESENT DEFERRED QUEUE (PCB INDEX)  |NPGLINK 


ee RELEASE PAGE COUNT | PRGECNT 


| 
|RB-%20} SPECIAL REQUEST TRBLE PTR (SRT TABLE REL) |SPECREQTABPTR 
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Nenory Nanagenent Tables 


Subregion Header (Reserved Regions) 


0123 4 5 6 7? 8 910 11 12 13 14 15 


[RB-Z17| SUBREGION ASSIGNNENT STATE [SAS 
| jc IR IR (R [R | } 1 | 
| ia j€ (0 J€ Ie | 0 | 
| jc JF Ic IF IF I | $s | 
| _ wt f2 3d ! 7? | 
[RB-Z16| SUBREGION SIZE IN PAGES Iss 
IRB-Z15|V | SUBREGION DISPLACEMENT IN MAIN NEN. PAGES Iso 
|RB-Z14) WRITE REQUEST POINTER junear 
H Cendcown cnn cocemnseess Coes eenoasesenseroseosonn 
iRe-213} ORJECT JoastDENt 
| IDENTIFIER | 
(RB-z11| FREEZE COUNT LOCK COUNT luerzcar 
|RB-Z10] -« URITE OISABLE 1/0 FROZEN | WDICFZCNT 
| COUNT COUNT 


| poco wcen ne nnwnmenscnne |aonnseneconncnnwerssssces } 
| RB-z7| LDEV HIGH ORDER DISC = {HODA 
| AODRESS | 
| iar, LOW ORDER DISC ADDRESS ioe 
| RB-z5| 
| ae | 
| RB-23] TINE OF Lene 
| ARRIVAL 
| RB-z1{ | 
| pone nnn we nnn nnn nnn nn neon meow oweenensoccrceccnnn | 
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Renory Managerent Tables 
bregicn Header (Asgiqned Region 


0123 4 5 6 7 8 9 10 11 12 13 14 15 


}RB-Z17| SUBREGION ASSIGNMENT STATE {SAS 
| jC IR JR IR IR J | 1 | 
| A JE 10 JE IE | | 0 | 
| IC (F IC IF IF | | $ | 
| . yf 2431 ) 7 
|RB-Z16} SUBREGION SIZE IN PRGES has 


IRB-Z1S|V | SUBREGION DISPLACENENT IN MAIN REN. PRGES |SO 


[RO-Z14] ss WRITE REQUEST POINTER |uREQP 
Ine-xi3} OBJECTS BS TBENT 
| IDENTIFIER | 
wea-xti| FREEZE COUNT | Lew COUNT (LXFZewT 
IRB-Z10|  URITE OISRBLE | 1/0 FROZEN | -—«*[WDIOFZCMT 
| COUNT COUNT | 

| ez7| ae | DER OTS oon 
| | RODRESS | 
| ne-re| tou ofDER BIC MOORES 
le-si000tt=<“‘™SOSC;*;” PaaS 
a ig cca aaa 
ma ne a 
7 ARRIVAL | 
| oT | a icine 


6.23.00 
2- 26 


Nenory Nanagenent Tables 


Global Region Header (Resiqned Requons) 


0 234 5 6 7 8 9 10 11 12 13 14 15 
ed ees ed bed ey bd pd be ord od 
|RB-Z30| REGION ASSIGNMENT STATE RRS 
ia IRIR IC IS IU IF IT IL I 18 | 
IS {E IV jt je Kk 12 JO 1S | ju | 
sist Ind IP iw ir it | In | 
rit wl rd iit It | 
ee Ih eee | 
{RB-Z27| REGION SIZE IN PAGES fis 
aise | 
iia , | 
ine 
ene 
sedi 
biel 
1R8-220| | 
|-nan-neneennen- oonnnnnnnnnsesnenneeneeeeeseeees | 
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Menory Nanagenent Tables 


Subregion Header (Cached Regions) 


01234 § 6 7 8 91011 12 13 14 15 


[-=|-n|==|-=|==|==[--}-=[--[--1--1--1--1-1-1-+1 


{RB-x17| SUBREGION ASSIGNHENT STATE 1SAS 
| jc (R IR IR IR | {| I | 
| iA |E 10 E fE | | | 
| Ic jf Ic |F IF | i s | 
| i" at (2434 | T 
renie) * SUBREGION SIZE IN PRGES Iss 
nes. | SUBREGION DISPLACEMENT IN MAIN REN. PAGES fag 
jRB-216} URITE REQUEST POINTER jUREgP 
(RB-213} OBJECT jeeseent 
| IDENTIFIER 
{R8-211| PREVIOUS CACHED REGION (RODRESS OF PD |PD 
| FIELD OF PREVIGUS CACHED REGION) ! 
| a8-z7} LDEV | HIGH ORDER OISC | HOOA 
| RDDRESS | 
| RB-x6| LOU ORDER DISC ADDRESS |LODA 
| RB-x5} NEXT CACHED REGION (RDDRESS OF ND |XD 
| FIELD OF NEXT CACHED REGION) ! 
| RB-x3} TINE OF eine 
| ARRIVAL 
{ my DISC ADDRESS 8CS$L(8) I{CRCOADISP 
6.23.00 
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flenory Nanagenent Tables 
Reqion Header and Trailer Fi escriptions 


RAS, Region Assignnent State 
f0:1) Region Assigned Flag 
.(1:1) Region Reserved Flag 
.(2:1) Regaon Available Flag 
-(3:1) Regaon Cleaned Flag 
.(4:1) Saze Change Pending Flag 
.(5:1) Region Locked Flag 
(6:1) Regaon Frozen Flag 
.(7:1) Region 1/0 Frozen Flag 
.(8:1) LSTT segnent, Region Nap Flag 
-(9:6) Not used 
21) Blocked Lock Migration in Progress Flag 


e 
e 
e 
e 
s 
e 
e 
e 
a 
. 
e 
e e 
° 
° 
e 
. 
. 


Qh at af a? of @* ot 8 


1 
2 
3 
4 
5 
6 
7 
8 
9 
1 


-( 


IOCNT, On-Going I/0 Count 
= # of on-going I/Os in the region uhich must conplete 
before the initiation nessage can be processed. 


INITASS, Initiation Message 
.(0:1) Message Processed Toggle Suitch 
(1 flessage Externally Orsabled Flag 
2 Message On-going 1/0 Disabled Flag 
3 Queue Segrent Read Disc Request Flag 
4 Incore Move Request Flag 
Expansion Request Flag 
Garbage Collection Flag 
Message Aborted Flag 
Release Residual Pages Flag 
OK To Start Conpletion Flag 
1) fiessage Valid Flag 


e 
° 
e 
e 
. 
° 
e 
e 
° 
° 
a 
e 
e 
. 
e 
e 
e 
e 


at ad af of wt ot ot od od 


-( 
-( 
of 
(5 
(6 
(7 
(8 
(9 
(1 


INITINFO, Initiation Message Auxiliary Information 
= ORO relative index of segnent read disc request if 
INITNSG. QREADREQ 31 


or 
QREADREQ = +/- Displacement to initiation nessage for noves 
and expansions. 


CONPASG, Completion Message 


.(0:1) Message Processed Toggle Suitch 
Segnent Modification Required 
Block Lock Request 
Send Scheduler A Message 
Auaken A Device 
Message Aborted 
Available 

) Message Valid Flag 


a et a? tae? Me? Men Mae? 
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Nenory fanagenent Tables 
ND, Next cached donain link for cached donain regions 


only. Contains the absolute address of the ND field 
of the next cached region. (2 words) 


ARRTINE, Arrival tine, contains the tine at uhich the segnent 
contained in the region becane present 


CRCDADISP Valid only for regions containing a cached donain, 
this uord represents the disc address (in one word) 
of the segnent contained in the region. This uord 
uhich exists in each nenber of a linked list of cached 
donains, is used as the target word during the LLSH 
instruction. 


fis of NPE V/P and V/E, one doubly linked list structure is used instead of 
the nultiple lists ordered by size as in MPE IV. SysGlob locations 2250 
through 2253 contain the respective head and tail (bank & address) of the 
available region list. These four words have in essence replaced the ARSBN 
and ARL data structures in NPE IV. Nenory allocation and deallocation is 
handled through PUTONARL and TRKEOFFARL. The search for an available region 
of the desired size is done via the LLSH instruction. The fornat of the list 
is the following : 


SysGlob 2250 & 2251 pointes to the absolute address of the NEXT LINK 
field (tuo words) in the first available region on the list. The 
NEXT LINK field in the first available region points to the 
absolute address of the NEXT LINK field in the second available 
region and so on. It is uorth mentioning that in addition to 
sesh a NEXT LINK field, each available region also contains a 
PREVIOUS LINK pointer, which makes nanagenent of the list both 
easier and faster. 


6.23.00 
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Nenory Managenent Tables 


MPQLINK PCB relative index of the HEAD of the make present 
queue. 


PACECNT, Release Page Count i 
z # of extra pages to release before processing initiation 
nessage. 


SPECREQTABPTR, A Special Request Table relative index to the list 
of devices queued on this segnent. 


SAS, Subregion Assignnent State 
(0:13 Cached region 
.(1:1) Referenced 
.(2:1) Recover Overlay Candidate 
.(3:1) Reference 2 
(4:1) Reference 3 
(13:3) I/0 Status fron region fetch 


SS, Subregion Size (in pages) 
$0, Subregion Displacenent 
(0:13 Displacenent Count Valid Flag 


.(1:15) # Pages to Base of Region 


WREQP, Urite Request Pointer 
= ORQ Relative Index of Disc Write Request uhen the 
Data Segnent 1n the Subregion is in Motion Out 
When the region belongs to a cached donain uhich 
is mapped (1.e., OBJIDENT = 30000/non zero nunber) 
this word 18 non zero. If the cached donain is not 
napped WREQP 18 zero. 


OBJIDENT, Object Identifier - has standard object identifier fornat 


LKFZCNT, Lock and freeze count 
.(0:8) Nunber of tines region has been frozen 
.(8:8) Nunber of tines region has been locked 


WOIOFZCNT, I/O freeze count 
(0: Not used 
.(8:8) Nunber of tines region has been iofrozen 


For regions belonging to cached donains, the above tuo words 
contain the absolute address of the PD field in the previous 
region belonging to a cached donain. 


HODA, High order disc addrese in virtual nenory of this 
region 
LODA, Low order disc address in virtual nenory of this 
region 
6.23.00 
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Dise Layout 
HAPTER ISC LAYOUT 
Systen Disc Layout 
SECTOR # | ---------------- one nnn nw nnn nnn - nnn nn nnnnnnn=|SECTOR 
z Oj DISC LABEL 10 
| berective TaaceS/SeCTOR TREN 
2] COLD LORD CHANNEL PROGRAN FOR HP-I8 Iz 
| RENOIR GIMME PRIA FOR TS 
Gn 
S| INITIAL PROGRANS Is 
ae “BOOTSTRAP” r 
| i: SEGHENT ‘\? 
; aol a 
1 om ‘Io 
; 1. UNH 


' 
t 


ag, SED GERD ERED EEE) SUE SE CE AE ee ee ED CED CEES OED GED GERD Gee ames ont gg F 


| LOW CORE (CST POINTER, QI, ZI, POINTER) | <--\ FOLLOWS 


eS a en | IMMEDIATELY 
| TEMPORARY CST (INITIAL PROGRAM) | | AFTER 
wecncnnecnencncnenenceceecccceccccenecccenee=| | BOOTSTRAP 

| INTERNAL INTERRUPT HALTS { | SEGHENT 

| BOOTSTRAP STACK | 


OOF O89 OOS OSS O 246 CFE 6 OSE OC O28 SSESE ©ESESSSSSSOESTSSASOBO 


j REMAINDER OF SIO COLD LOAD PROGRAN | 


| O88 0 8OSO8S2O8 Oo O82 OSS 2984 OF OS 42SSOSSHSTOSRS2OECCR j 





9S SOSE40 8 OSE S44EE4E SSO SSSESNSESE SESE SSE SSEESEE8 >a a ae 5 de ded 


INITIAL PROGRAM SEGHENTS 
| (EXCEPT BOOTSTRAP SEG) 
| SYSTEN FILES 

(FROM COLD LOAD TRPE) 


Disc Layout 
sten Disc cut n 
SECTOR W | craven enneennnnernrren cena ane nnenerennewecane |SECTOR # 
| --eenena-oonnennnnnennnnnnennenereensnennceen 
%| DISC COLD LORD INFORMATION TABLE 128 
| enaeemecwecnnwesewencon scensnceesocnenesesacea 
351 DISC COLD LORD INFORMATION TABLE {29 
36| DISC COLD LOAD INFORMATION TABLE HR ¢) 
37| SYSDURP/INITIAL COMMUNICATION RECORO 31 
| caceccwns sec coceccacosssenesnseccosneoesseseon 
40] DISC COLD LOAD INFO. TABLE EXT 132 
41] DISC COLD LOAD INFO. TABLE EXT ‘a 
| | 
SYS0B | eoewen eno wen won n cron wren nw ewccwnnwwocconcnce| 
eone-)> | | ---> NOTE: INITIAL 
2130/131| | TRIES TO 
| SYSTEN OIRECTORY | ALLOCATE 
| | DIRECTLY AFTER 
| pope cnnnww ewer en meee enneewe enn scenserenenosee j THE FREE SPACE 
i | MAP, KOWEVER, 
| | THIS AY 
l | VARY DEPENDING 
| | ON DELETED 
| VIRTUAL MERORY AREA | OR REASSIGNED 
| | TRACKS 
| | 
| | 
| 
| 


VOLURE TRBLE 
INITIAL PROGRAM STARCK 
REMAINING INITIAL CODE SEGHENTS 


USER FILES 
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Dise Layout 


i 





| 
31] UWCSLE1.PUB.SY$ High Order Disc Address 25 *MICRO/XE 


encccnecceneennennenenecnewcncencecesorscencene | UCS IMAGE 


32] UCSLE1.PUB.SYS Low Order Disc Address 126 POINTER 


aseoaeve PP OOO SS 29SS 6 BOS GEE 2ES46 2408 2 2O8SSSSSE4SEES88ERE 


33| WCSLE2.PUB.SYS High Order Disc Address 127 *AICRO/LX/GK 


wenennrncncnenceceeeneneccwecccncccnccccenncenee| — UCS IMAGE 


34] UCSLE2.PUB.SYS Low Order Disc Address {28 POINTER 


BSS SDSS 8 ODS E © OSS CFSE OS SSHSSSE PHSESIVSP SSSCSVSVSOSSTSOSO® 











381 ifs 
RESERVED 
| PD ES PED Tb AP EEDA EPS OP DD DP OD FS EPSP OF BO WD | 
170 J120 
171]  OISC FREE SPRCE NAP OK FLAG 121 
172] DISC FREE SPRCE MAP DESCRIPTOR 1122 
| TABLE CHECKSUM | 
173) OIC FREE SPACE DESCRIPTOR TROLE 1123 
! DIRTY FLAG | 
74] 1128 
l= DISC FREE SPACE DESCRIPTOR - 
175) TABLE ADORESS [125 
176| 1126 
|- DISC FREE SPRCE BITRAP ADDRESS -| 
177| 1127 








* UCS inage pointers point to the start of the CS 
data (File label address ¢ 1). Always on LDEV 1. 


| 
| 
| ** As of V-Delta-5 (6.03.05) the way the COLDLORD ID’s are 

| used has been eaanges. A Volune set ID (VIO) has been 

| created to logically link together @ set of discs. Originally 
| the COLDLOAD IO peforned this, se well as enabling the FILE 

| SYSTEM to tell if the file was open when the systen failed. 

| The VID is KOT changed on each systen start, only on a RELORD. 
| In order to maintain backward conpatibility, the old COLDLOAD 
1 ID locations have been changed to ROLLBACK COLDLORD ID's. The 
| actual COLDLOAD ID (for FILESYS) is in the Disc Cold Load info 
| Table (OCLT) word 46 (256). 


6.23.00 
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Systen Volune 
01234 5 6 7 8 9 10 11 12 13 14 1§ 
ey es bed ed eee ed rel Do edo 
I 0 
1| 0 j1 WORDS 0-5 CONTAIN 
| enn ccm c enn ew wn enw mene cc nenewnmenecesecnnnasonces | THE ASCII STRING 
zi. 8 j2 “SYSTEM OISC " FOR 
| | pee w nme n nnn common cwnccewwennnwennewnsneccceens {| THE SYSTEM DISC, 
| 4 0 3 ONLY. 
4| 0 {4 
|-------nnnnnnnnnnnnennnnnneneneneneinnweeceeren | 
Ft 0 (5 
' Z | DISC TYPE ponncetiAa 
j 7 ROLLBACK COLD LOAD i RASEE NOTE BELOU** [7 
| fenwnwnneennnnnnnenennnn | concen enn wanna nenenence 
ss “gy bid «bi is 
} 44 a | “or {9 IF WORD 211 
| | eoew nomen erneenececoens | peo no eee ewocecoenne= | CONTAINS A "1" 
{2| 110 A FORMER SYSTER 
| | VOLUNE HAS BEEN 
13] }11. SCRATCHED. 
| VOLUME NANE | 
14| 112 
| i 
" i 
| 16| UNUSED j14 
| mT UNUSED {15 
20| VOLUNE SET ID RASEE NOTE BELOU** |16 
tea UNUSED [words 17-20 (221-224) UNUSED} 17-20 
| 25| SYSUCS64.PUB.SYS High “Order Disc Rddress |21 gk ucs 
eccen ewww ene w rene wne nnn ne nwncecoccrceenneeee nA 
! 26] SYSUCS64.PUB.SYS Low Order Disc Address |22 POINTER 
27| SYSUCS37.PUB.SYS High Order Disc Address |23 *37 ucs 
| 


6.23.00 
3- 3 
Disc Layout 
Seria) Volune 

| ennn nn sere renee nn ene n nnn en nwonnnw ew ennnneeccne| 
0| 10 

| 0 (:STORE) | 
1 \1 

| OR | 
2| {2 

| COLDLOAD SIO CHANNEL PROGRAM (NON-HP-1B8 = | 
3| MACHINES ONLY). FOR HP-IB MACHINES, COLD |3 

| LOAD CHANNEL PROGRAM IS IN SECTOR 2 AND | 
| SOFTOUNP CHANNEL PROGRAN 1s IN —o 3. \* 

1 11 

Re ‘: S - 3 4 S 678 9 ; 1 2 3.4 5/5 
6|SC|MvISRI | TYPE IREDIA TYPE*I6 «= SC #1 

a ed ed eee ae wonecece a | SCRATCH VOLUNE 
7| 17 (Vs 4 # MASTER 

| | “OCR OF PV SET. 
10 0 jg SRs 

| SERIAL prsc 

11] \9 

| ennecenennnnnnnewennee | cocenn none neneenewenonne| 
_ re "| 
"I “Re "9" u | VOL WARE 

saaceceeooesocosoucces | conccwsesewocceasseresoes > 

i") a “s" i "SEROISC® 
15] ocr i sorsc {13 / 

| ese 
16] WORDS PER SECTOR te \ 
SECTORS PER TRACK (CARTRIDGE TRPE © 4) = 415 | 
20] SECTOR RODRESS OF BEGINNING OF TAPE (BOT 116 | 

| pone ne wee cone n nnn nnn w nnn nn enon nn nn enneenncone } | SERTAL 
211 DOUBLE ADDRESS OF \17 > OSC 

|- -| | INFO 
a) END OF TAPE (E0T) ise 
z3] DOUBLE ADORESS OF "2 
24} END OF DATA (EOD) has / 


Disc Layout 


isc Lebel (Sector 0 of 


| noon -nenencennnnnnnnnnneceenerscncnncnnenneeeee | IMAGE 
30| SYSUCS37.PUB.SYS Low Order Disc Address [24 POINTER 


28 OSES OS OBO OO 6 6 © OOS OC OS & OSHVSNS THEBES STOHSDBO**ASOSOS“O 


) f 
{25| SYSwCS64.PUB.SYS High Order Oise Address = [21 ll 


1 1 I 
fe: SYSUCS64.PUP.SYS Low Order Dise Address 122 POINTER 


6.23.00 
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-———_— = . = eS 





wree ie menart oom ee 





Dise Layout Disc Layout 


Serial Volune (Cont.) Master Volune (Cont. )} 
234 5 67 8 910 11 12 13 14 15 


09088 O28 OO O8 68 6808066 298888 S SSS DBTBA OO OS BQASS 


| 
}27] (See SYSTEM VOLUME words 225-254) [23 

















| 
| 
| 2s| 
| 26| GROUP \22 
e RESERVED FOR FUTURE UCS > | 27} NAME 123 
122| ise ait = 
123| CYL |83 | 1 {25 
| sennewecntnccnesnaensss J ecocneeeennneenennoe-e= 32; VOLUNE SET 126 
124| HEAD | SECTOR |84 ‘ 33] NAME 27 HEADER 
|-ne-nnnwncenceneennnees |-enennnennnnennennnnen | | 34| 28 
* MEDIA TYPE is the device subtype for all serial volunes except cartridge | vS VTAB 35\ \29 
tape. For cartridge tape, this field is always 0 (the HP 9110 subtype), | HEADER + [ew--seneene | eresoneenn= [nceeaeemetsesseseeeas | 
despite a different actual cartridge tape subtype. This allows both | 8 ENTRIES 36) COUNT | | VNASK 1x 
forward and backward interchangeabilaty of cartridges between the HP 9110 | COPIED FROM |----------- Joceneensone [Ssaeeeeasssaeseeecesoae | 
and HP 9144. | VSET OEFN 37} |31 
| IN SYSTEM 40] VOLUNE 132 
| OJRECTORY 41] NANE 133 VOLUNE 
faster Volune 42| 134 ENTRY 
| 1234 5 6 7 8 9 10 11 12 13 14 15 | | enae wenn nnn nnn nemo nnn nen ennn nse een nrewecerenn=| 
ed ee es od be do et De eo | 43| 135 
| 0} 10 [it -  <[Steessescesersserassecs| ote = ees | 
| 1} iH | 44| SUB-TYPE | VTRBX 136 
| 2] 0 j2 | J s)esteseeecseenseseeeces | sorses= seme Ssssesssos= | 
{ 3| \3 | 4S] |37 
| 4| 14 | | | 
| 5| \5 | es . : 
IIE Coed Cond Gon | coconece | nomen eneceneesene | eocceennnne | | VOLURE 
| SC = SCRATCH 6ISCIAVISR| | TYPE | SUB-TYPE (6 | | | ENTRY 
| VOLWAE Jo-|oe foe |eonenee- | eremeoce conn nnn ce | eeneneonn= | | 116] \78 7 
| MV = MASTER 7] GENERATION INDEX |? | Jpseesesecsesereorcesseesressrrerncensos sen | 
| VOLUNE 3 10 |eewerccencwen ncn en nnn ceswnmnnsswocwocornccerewes | | . 
| SR = SERIAL 10] 0 \8 | 
| VOLUNE 11] \9 | eee cone wr cocwenncennnccrocoecoocccnccccororence 
| | coe nnn n nnn nomen nnn www en ennnwnenanwocccooswcnes | | 170] \120 
| 121 110 | Seneeasasesseeseee Secdsadseasesaaeonpesaasssexe 
| 13 VOLURE 111 | 171] DISC FREE SPACE MAP OK FLAG {121 
| 14] NAME }12 | wecce cree rene neneewenenec er enroseesococoncecene| 
| 15 {13 | 172| DISC FREE SPACE DESCRIPTOR 1122 
| ween nee ew enn c nec concccow ccc cowesenncscoeswecoces | | | TABLE CHECKSUM | 
| 16! INITIAL DATE 114 | | co ene ncn wewenneecwesenrecwsreneserenncecscococe | 
{Je eewcwc ec nwer cen enemnecnswnnsccornnocnneowsenn | 173] DISC FREE SPACE DESCRIPTOR TRBLE \123 
| 17| DIRBASE 115 O=NOT | | DIRTY FLAG j 
| | pone nnn n nnn neem wenn newer n ewer nn eweneoenwocace | MASTER | | peewee ween nnn wneweneoe ne ennnenee se meenweceen= | 
| et DIRSIZE the VOLWNE 174| DISC FREE SPACE DESCRIPTOR |124 
| 21] |17 | 175] TABLE ADORESS 1125 
| 22| ACCOUNT 118 | conerersore ones enacssasceerersnonse= | 
| 23| NANE 119 | 176] 1126 
| 24 | |2 | l- DISC FREE SPACE BITMAP RODRESS - 
| [Reeaseastathanse>e<eeasssserane aera seenr seen | | a Ne 
6.23.00 
3- 6 6.23.00 
3- 7 
Dise Layout Dise Layout 
Slave Volune Slave Volune (Cont. ) 
| 2345 6 7 8 § 1011 12 13 1415 
| [-=[-=|-=1-=1-=[-=1--f-- = 1-al--l-- 1-1-1 -1-=| | 7 : 
| lo | | ---------nnnnnnnnnnnnnnnannnnnnnnnennnnnnnnenae| 
| 1| {1 | 1%| 1120 
| Z| 0 (2 | | pee ne wenn new ewnmnnecneco ew nn nec cneencceoccnen| 
A a | 171| DISC FREE SPACE ARP OK FLAG j121 
[SC = SCRATCH 5] \s { 172] DISC FREE SPACE DESCRIPTOR \122 
| VOLUNE 9 =—«-_ [en fo= Jon fone nn-neon | eoeoreceesene= Jercernseeee | | TABLE CHECKSUA | 
|v = MASTER GISCIMVISRI | TYPE | Sug-TYPE (6 | | prow wn nnn own ewww nn esee cee sowenseeeen woneconwee 
) VOLUNE #0 = Je-|--|--|-----2----- | -- 22-2 enn nn = [ones nn eee=| | 173| DISC FREE SPACE DESCRIPTOR TABLE \123 
JSR = SERIAL ?7| GENERATION INDEX |? | | DIRTY FLAG | 
| VOLUNE | enn mmm mmc wn cree nme een cnn weroenereccercooson | | | enon ee nnn nen eoonn nee eoseeeennnnnne------ | 
ant 0 i‘ | ea DISC FREE SPACE DESCRIPTOR Ma 
| | poecc nec ocewerocenewnnnsccwceseccscenorcroonere | | 175| TABLE RDORESS J125 
| 12| \10 | wreroreenecnecncewnconewennncneenweweresecnenen| 
| 13| VOLWAE [11 | 176] 1126 
| 14| NAME {12 | |-  OISC FREE SPACE BITMAP AODRESS - 
15| ti ve we 
16| INITIAL DATE fag 
| 17| 0 115 
| 20) \16 
| | eownwwewecccewecennsnwceneeronns con cccceseeenen j 
| 21| \17 
| 22] ACCOUNT {18 
| 23| NANE 119 
| 24] |20 
| | -o2------neennnnnnennannnnennnn anne seenennen ---| 
| }21 
| 26] GROUP 122 
| 27] NANE {23 
| x” 24 
| | pone nae ce en were nnnn nw nnwe weno eennnnnnneennen=| 
| 31| |25 
| 32| VOLUNE SET (26 
| 33} NANE \27 
| 34 j28 
| 
5.23.0 6.23.00 
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Disc Layout 


fective Tracks Tab] ector 1 of Dis 
Not Used On CS-8 Discs 


23465 6 7 8 910 11 12 13 14 15 
maa ee eed ped ed be Pd ee 


0 # OF DEFECTIVE TRACK ENTRIES (N) lo 


| 
1| DEFECTIVE TRACK NUMBER 


orc |1 120 DEFECTIVE 


| TRACKS MAXIAUN 
2| DEFECTIVE TRACK NUMBER orc 2 
| | 
; | 
170] DEFECTIVE TRACK NUMBER | orc ie 
174] ie 
172| 1122 
| RESERVED FOR | 
173] FUTURE USE Ve 
Hg 1124 
i CHECKSUM DOTTCKSUN 
176} NEXT AVAILABLE ALTERNATE TRACK 1126 
177| LOGICAL OISC PACK SIZE (CYLINDERS) et 
OR # OF TRACKS IF FH DISC 
orc (DEFECTIVE TRACK CODE) 
0 suspect 
1 suspect alternate 
2 deleted 
3 reassigned 


NOTE: The situation where there are tuo entries for the sane track, n, one 
having a DTC of 0 (suspect) and the other having a DIC 3 (reassigned) 
results fron a situatzon uhere the disc driver could not “read” 
(unreadable) the addrese of the particular track. 


| DTTCKSUM (Systen Volunes only): | This is an EXCLUSIVE-OR 
checksun(fron a base of -1) of the DIT | excluding word 2175. 
Each tine a suspect track is inserted or | modified, a neu 
checksun is calculated and stored in word 2175. | At systen 
startup INITIAL recalculates the checksun and conpares | fae’ 
original value at Z175. If the checkuns do not natch | 

COLDLOAD ERROR 202 (MOUNT CORRECT VOLUMES OR RELOAD) will dear: 


6.23.00 
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Dise Layout 
Reserved Area Bit fi r 4 of th n 


The first 400 sectors of the systen disc are reserved for Initial’s use. 
This area contains pernanent data structures for the boot. It is also used 
as a tenporary storage area for data during sparing. All other systen 
volunes and private volunes reserve only the firet 10 sectors of the disc. 
They do not have a reserved area bit nap. 


The bit nap contains 1 bit per sector. A °1’ means the sector is free. 








| pomeweenenn ne | 
" | 
| RESERVED AREA . | 
| BIT NAP | 
| | 
| ! 
| | 
cP ta 
231| (25 
! RESERVED FOR | 
| FUTURE USE 
1 ! 
: 
a) Met 
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Disc Layout 






Sector Table (OSCT -- Sector 1 of Ois 


(The OSCT Exasts On Device Type 3 (CS-80) Discs, Except Cartridge Tape) 


012345 6 7 8 91011 12 13 14 15 


| 
O| NUMBER OF ENTRIES IN THE TABLE 


| 
x1 INDEX TO THE FIRST ENTRY (6) 1 


| ee et Th Pry 
z2| ENTRY SIZE (2) l2 
243] “MAXIMUM NUMBER OF ENTRIES (275) 3 
| eeaneccece cece ceces assess seneeccevesesoosaeaaace 
Mt © (RESERVED) f 
*8| 0 (RESERVED) \s 
16] FIRST DEFECTIVE SECTOR ENTRY 16 
zl (OQUBLE-WORD LOGICAL SECTOR ADDRESS) |7 
110] SECOND ENTRY 8 
a 9 
z12| THIRD ENTRY 110 
m3) 119 
| 1 
| | | 
1176] MAXINUN DEFECTIVE SECTOR ENTRY 1126 
x71 W127 


Unlike the OTT, entries in the OSCT are not permanent. Once a suspect sector 
is handled by INITIAL, SOISC, or VINIT, its entry 18 renoved fron the table. 
Thus, this table contains only unprocessed suspect sectors. 









































6.23.00 
3- 11 
Disc Layout 
nfornation T tors - 
45 6 7 8 9 10 14 12 13 14 15 
|-=[-=]-=|-=1-2]-=|--1-=1-e1-21--1--1--1--1-=1--| 
0] POINTER TO TABLE INFORMATION |FREFTR ama 
1] POINTER TO TEMPORARY CST INFO (TCSTPTR 
2| @ OF ENTRIES TO READ ON DISC COLD LORD |WREARD | 
3} @ OF CODE SEGMENTS IN INITIAL [wVTCST? 
4| INITIAL’S 08 VALUE [INTTOS 
5| INITIAL’S OL VALUE |INITOL | 
6| IWITIAL’S 2 VALUE | INITZ 
7| IWITIAL’S Q VALE |INITG 
10} INITIAL’S S$ VALUE {INITS 
ut SYSOISC TYPE | SUBTYPE (DISCTST 
12] ROLLBACK COLDLOAD ID **See note below** |COLD’ LOAD’ ID’ 
13] LOG FILE NUMBER ere ! 
14| DIRECTORY DISC | | 
{ {OITRROR | 
15| RDDRESS 
16] LOEV 1 VIRTUAL RENORY | { 
|VIRMENADOR | 
17| DISC ROORESS 
a @ LOG PROCS anieltinee 
at LOGS x0°Ss | LOSIOS 
22| RIN TRELE | | 
[RINADR | 
23| DISC ADORESS 
24 DIRECTORY SIZE JOIRSECT 
S| SECTORS IN VIRTURL RENORY REGION {SECTORS IN LDEVIVA | 
OF LDEV 1 iene 
o VOLURE SET ID (VID) **See note belou** 
a RIN. TABLE SIZE {RINSECT ! 
6.23.00 
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Disc Layout 


eee ame * oe CREE | ee ee owen ae eee oe ere 


Dise ad Infornation Table 


01234 5 6 7 8 91011 12 13 14 15 





~ @ OF RIN |RINS 
31 # OF GLOSAL RINS |GRINS 
| 9898008008 008 £046 08 OSES D889 S S886 BODES | oo | “2° { brid | TLsTAPE coLD LOAD 
32 |TLIRLIRY{| LOAD MODE 
eee ee | concenweeenene|--|--|-- { RL=RELOAD 
| | | RY=RECOVERY 
331 fnAX VOL | HIGH VOL pone 
| ocnnnnernnnenen enn nnn= | oo enn enn n anne nenneeene= 
3%) DISC COLD LOAD ENTRY POINT |OISCENTRY 
s] SYSTEN DISC DRT NUMBER |SYSDISCORT 
| eT 
36] JOB MASTER TABLE | 
| | JMATLOC 
a DISC ADDRESS | 
4} | 
| 10D OISC ADORESS | TOOLOC 
att | 
| ---nnenennnnenennwennnnnnennnneenncceenencnnnne| 
42| 
| ODD DISC ADDRESS |OODLOC 
a 
44| WELCOME RESSAGE (ost 257) | 
| | LOGONLOC1 
o OIse RODRESS | 
46| WELCONE NESSAGE (OST 260) | 
| | LOGONLOC2 
a DISC ADORESS 
S| | 
| LOS ID ADDRESS | 
51| | 
| coen en wenwnc cone nwenwnncncnncnwwowccnnes eoenene| 
52 | 
| LOG TAB ADDRESS | 
" : 
a LOG ID SIZE 
ea LOG TAB SIZE | 
COLDLOAD 1D 22See note belou** 
6.23.00 
3- 14 
Dise Layout 
Dis d d Inforn T 
| SIZE IN WORDS |FREFTR+25 
| COMMUNICA-| 
| RENORY ADDRESS SUBSYSTEM | 
| TABLE | 
mente nenceennnnn= a-nonnn= | 
| DISC ADDRESS 
! | 
SIZE IN WORDS rey 
| LOGICAL- | 
| MENORY ADDRESS PHYSICAL | 
| DEVICE | 
woee ce weccconweee woeccecesenccccccs § TABLE | 
DISC ADDRESS | 
| 28S C28 £24244 64628 4689S FSS BASESSSES Bi le i | faded 
SIZE IN WORDS ia a 
\ LOGICAL- | 
| MENORY ADDRESS DEVICE | 
| TABLE | 
ees | 
! DISC ADORESS 
Ce A EE OD Th SD SD A Be EP Ey GPS Pa a | 
SIZE IN UORDS- Kies 
| DEVICE | 
| MEMORY ADORESS CLASS 
| TABLE 
eeec aceon ccecewsnswcesnwssesene — 
DISC ADDRESS 
H SIZE IN WORDS FREFTR+45 


MEMORY ADDRESS TABLE 


OOOO FOO © OSS & 68 S808 8SES8SE 88S 2EOE8SSES8R 


DISC ADDRESS 


| 
| 
| 
| 
| 
| 
voune | 
| 
| 
| 
| 
| 
| 
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ee ee ee 


sc C ad Information Table (Cont. 


| 
| SIZE IN WORDS oo 
! ake ARIVER | 
{ MEMORY ADDRESS | 
| TABLE | 
t Swscedcddcdcddncadtesacsosecesoesscess | 
! | 
OISC ADDRESS ! 
| pone cee nnn nen e nn cern nee nwnen en naneswencocnocen | 
| SIZE IN WORDS ELISE 
| eee ce cme eseecwsswcconawsconcusscsce 
| . | 
| MEMORY ADORESS 2CTABO | 
{ 
(ici ae ana | 
| DISC ADDRESS | 
: | 
| SIZE IN WORDS |FAEFTR*10 
[a | 
| MEMORY ADDRESS *CTAB | 
| prorow enero neem enn ewecenecononecce | 
| [ 
| DISC RODRESS | 
| | 
| SIZE IN WORDS a |FAEFTR#15 
| pov nn nnn n nw nnn nnn owen enn ne serene COMNUNICA- | 
| TION SUB- | 
| MEMORY ADORESS SYSTEN = | 
| DRIVER | 
| penn nn nnme enn nn mene en enanennn------ TABLE | 
| 
| DISC ADDRESS j 
| | 
SIZE IN WORDS a |FREFTR+20 
eee en ence wen se new ec ccc ennoconoenne COMMUNICA-| 
TION SuB- | 
MEMORY ADDRESS SYSTEN | 
DEFINITION] 
woe cee wnwen wn ew wenn necnenneesewecee ABLE | 
| 
| 
| 
| 


OOO OB 8 OS © OB OS SO OOS SOSSES COS4 4S OOS CTS CASHHVSO“*STOCS 


nfornation Table nt. 





DISC AODRESS 


| SIZE IN WORDS (FREFTR#SO 
{ LOGICAL | 

j EMORY ADDRESS DEVICE =| 

| TABLE | 
pe ae woccecencecenn= EXTENSION 

| DISC ADDRESS | 

| ; 

STACK SIZE ree Ane 
] INITIAL’s | 

| MEMORY ADDRESS STACK 
(ee 

| DISC ADDRESS | 

| ! 

SIZE IN UORDS ireeeInee 
| DEVICE 

| MEMORY RDORESS CLASS | 

| TABLE | 
eaaaaeeams HEADER 

| DISC ADDRESS { 

| | 

SIZE IN WORDS Taeee 
| TERMINAL | 

| MEMORY ADDRESS DESCRIPTOR | 

| TABLE | 
[oo eee ee | 

| DISC ADDRESS | 

| | 

| SEGNENT SIZE IPAEETR?O 
| INITIALS | 

| MEMORY ADORESS SySOUNP =| 

| COMMUNICATION] 

ae ey wocecenees RECORD 

| 

| 
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Dise Layout 
ad Infornaticn nt. 

as nenennnennnenenenn 

| SEGHENT SIZE JFREFTRO75 
| DEFDATA | 

| ‘MEMORY ADDRESS TABLE | 

| LOOKUP si 

| neecenncennnennnnnenneneecnennnnee= BUFFER | 

| 

| DISC ADDRESS | 

| 

|--c--ceeecceeneneneennnneneennseecnnnnenewenee 

| IFREFTR+8 

(INITIAL’S SEGHENTS) 
ININ 
|-----ncennnerecennevnnnnenennennenennnennnnen| 
6.23.00 
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Disc Layout 


YSOUNP/Initial Connunication Record (S e 137 


111101 
0123456789012345 
I-1-I-I-t-}-t-t-1-f-d-t-t-l-d-t| 

HIT VERSION 0 


1} MIT UPDATE {1 
cmp 2 
1 wna? {3 
a ee \, 
ee 
ol ene. sertwane SvSTEN nO. [6 
1 nieaest or {7 
ol NOES Le ls 
nt mayan | rea von 
a} w OF ADDL DRIVERS Ito 
at to le oT in 
ul uso c 
|o-nnnnn- nen ene nneene--e- I-I-I-|  FaoSet if FOS Syedunp 


15{ SERIAL DISC LORD {FIO1S|13 De>Set if Future Date Sysdunp 
|-ncccenneneeeennneenen---[-|-|-|  SsSet if Serial Disc Sysdéunp 


16{ TAPE RECORD SIZE \14 
17) DISC COLD LORD ENTRY ‘|S 
20, naw INITIAL SEG SIZE ING 
a] SPRREsS=C=<CS~sSCS 117 
22] SPREtst=—=<“C=ists~S i18 
23) SPREsSs=—<“C=sSCS I19 
zal bev cuass Tad SIZE deo 
25] TERM DESCRIPTOR SIZE i21 
ae} ow v"Re SIZESStC~* 122 
ann two sit Sane 2 
6.23.00 
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Disc Layout 


NITIAL Progran CST fa 


LOGICAL PHYSICAL 
cste cste SEGHENT ANE 
0 1 ININ \ 
{ 2 BOOTSTRAP j----> Core Resident 
2 3 RESIDENT / 
3 4 NAINSEG? § \ 
4 5 MAINSEGIA | 
5 6 CONFIGURE | /Moncore Resident 
6 7 DEFCTRACKS] |but present in core 
7 10 SETUP [----->]at completion of 
10 11 TAPEIO | \Cold Load 
11 12 FILEIO = | 
12 13 DISCSPACE / 
13 14 DIRECTORY! 
14 15 DIREC TORY2 
15 16 SL PROGRAN 
16 17 PROCESS 
17 20 MAINSEGIB 
20 21 MAINSEG2 
21 22 MAINSEG3 
22 23 MAINSEGS 


£Code segnent suapping starts at conpletion of MAINSEGI 


|*® As of V-Delta-5 (6.03.05) the way the COLDLOAD ID’s are 

| used has been changed. A Volune set ID (VID) has been 

| created to logically link together a set cf discs. Originally 
| the COLDLORD IO peforned this, as well as enabling the FILE 

| SYSTEN to tell if the file was cpen when the systen failed. 

| The VIO is NOT changed on each systen start, only on a RELOAD. 
} In order to maintain backward conpatibility, the old COLDLOAD 

| ID locations have been changed to ROLLBACK COLDLOAD ID’s. The 

} actual COLDLORD ID (for FILESYS) is in the Disc Cold Load info 
| Table (DCLT) word 46 (256). This value is put in SYSGLOB(Z75). 
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Dise Layout 
a] n ication Record nt. 
lef-lelelef-l-l-lel-b-t-t-1-1-l-1 
i CS TABLE SIZE i" 
| 31] TABLE LOOKUP BUF SIZE {25 


asa anegoeeeuce BODE DNDE DOSS OOOCSZOCS 


| | TABLE LOCKUP BUF ENTRIES  |26 


eaves cceecussccedscasuwocees f 

| 33] SYSTEM TRPE LOEV ® \2? 

| M4]  SPRRE i 
35] SPRRE \29 


36} CONVERSION BITS WORD 1 © [M]30—M=(15:1) NPE Version 
[evecewcewecncencnnnnceeenece=|-|  OsMPE (6.00.00) 
37] MIT FIX LEVEL INDICATOR ** © 131 t=MPE (6.01.00) 


40| CONVERSION BITS WORD 3 |32 


| 
41| CONVERSION BITS WORD 4 133 


8288S OSO0SOSE 244 682242686 S8EEES88 | 


42| SPARE {x4 
oom is 
“a ee 
“oo 
“ao ne a 
| <= 
sol We FILE ween 


822 2OS8 © OSSSO S 68 82S CESSES SSSSS4SOSO 


51) LAST FULLBACKUP DUMP ORTE [41 


8 888882 2028S 2828S OE 8SE8S8KSSOO { 


#& Rg of V-Delta-5 (6.03.05) uord 31 (237) of the SYSDUNP/INITIAL 
COMMUNICATION RECORD is now used as the AIT FIX LEVEL INDICATOR. 
It was previously used as the CONVERSION BITS WORD 2. 


As of V-Delta-5 it (uord 237) will contain the value 2170005. 
The °5’ in bits (13:3) is added by INITIAL during the update 

to V-Delta-5 eo INITIAL will know that it is using the new 
COLDLORD ID/VID nechanisn. 

Bits (0:4) signal that the following tables have been converted 
to RPE V/E fornat: 





0 - I0 tables converted. 
1 - Cold Load Info tatle converted. 
2 - Rin table converted. 
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Disc Layout Dise Layout 
| 3 - Sysdunp initial Conmunication record. old Load Information Table Extension 


The Cold Load Infornation Table Extension 18 a part of the Cold Load 
Information Table that has no use in booting the systen. It exists for 
different systen level processes to hold information that uould only be 
created during a RELORD. A gocd exanple of this is the systen log file 
nunber. This is only created on a RELOAD, and changed uhenever a log file is 
full or a boot (other than a RELOAD) is perforned. 





In order to protect tne Cold Load Info Table, the extensicn uas created. In 
this way no I/Os should be perforned to the Cold Load Information Table 
during APE operation. However to process data into the Cold Load Info 
Extension a process nust use the access routine "PROCESS’ COLD’ LOAD’ INFO". 
The exact calling sequence can be found in KERNELD. 


The Cold Load Infornation Extension is 2 sectors long and innediately follous 
the SYSOUNP/Initaal Connunication Record starting at sector address #31 on 
logical device 1. The assigned entries are as follous: 





Sector 240 
| ----------nenneenennennnnnnnennennnnennncnnnceneennne | 
} Of jo 
I -| 
i 
}  2t RESERVED FOR FUTURE SYSTEM USE le 
|- -| 
| a tag 
} 25 SYSTEM LOGGING FILE NUMBER jet 
| 26] NETWORK MANAGEMENT LOGGING FILE XURBER j22 
| 27 NETWORK MANRGENENT TRACE FILE NUABER j23 
1 Xl FULL/PRRTIAL COMMAND OUNP DATE jee 
} 3] fig 
| | as 
| = NOT CURRENTLY ASSIGNED te 
| | |28 
I “| 
| -| 
| 37?| |255 
| ------nwnnnnnnnnnnnnennnnnne wescceenennne| 
6.23.00 
3- 22 6.23.00 
3- 23 
Disc Layout Dise Layout 
Virtual Dise Space Nanagenent Structures VOSHTRB Entry 0 Fornat 
Disc space for data segnents is allocated fron reserved regions of systen 012 34 § 6 7 8 9 10 11 12 13 14 15 
volunes uhich have been assigned the virtual nenory supporting (VAS) wo |---| --|--|--]--1--1----]--1--]--1--l--1--! 
attribute. The data structure used for accounting and nanagenent of the VOSMTRBOO | @ WORDS IN VOSAT |TABLE LENGTH 
virtual disc space of the various VMS volunes is the Virtual Disc Space Table | meen nn ewe nn ewe emcee romeo ewerewecnewcencecocccce 
(VOSNTAB). This structure consists of a circular list of entries, one for VOSATRBO1 | @ SYSTEM VOLUMES WHICH HAVE [VASVOLURECNT 
each VAS volune. Each entry contains the infornation defining the state of | VIRTUAL MEANCRY 
the virtual nenory region cn that volune. | neon en nn ne nnn nenceencennseenesenece woecccecee-| 
VOSNTRBO2 | INDEX OF NEXT ENTRY TO ALLOCATE FROM [STRRTENTRY 
VOSMTABO3| Vm PAGE SIZE (512) |VAPRGESIZE 
irt isc Space Nanagenent Tab | concen nce ren ceenececreesennawncewssscoscorocces | 
VOSHTRBOS | # SECTORS/VM PRGE (4) Pear 
VOSNTAB DST# = 39 (247) VOSHTRBOS | OFFSET FROM ENTRY TO BITMAP (220) |CFFSETTOEN 
VOSMTABPTR = Absolute(Z1026) = SYSGLOB 226 | peeewn nnn nn monn nce wwe een cen ncn ccwwnrcenecr cones | 
VOSNTRBOG | TOTAL @ Vf PRCES CONFIGURED IN SYSTER ta See below 
ner tu VOSMTRBO? | LEAST @ OF VN PAGES TKAT HAVE | 
| EVER BEEN AVAILABLE 
| | 
Z1026------>| HW VAS VOLUNES | ig i 
| FIRST TO LOOK a VOSMTAB %10-Z17 UNASSIGNED 
[oweno=> [ranceceee cee nncnenemecnnnnncerennennnenconeseos| 


aa NEXT IW LIST 


\--> 


2 && This 16 bit field can only accommodate 32K Pages or 255K sectors. 
ae WEXT IN LIST 


j 

( 

| Each velune can have up to 255K sectors of virtual nenory. This 
word will overflow if there are more than 255K total VM pages 
| 

| 

| 

| 


conf.gured en all eysten discs. NPE does not use this word. It 
instead uses the general VDOSNIAB entry for each volune to find out 
the total virtual nenory sectors on a particular volune. 
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Oise Layout 
VOSATA ral En Forn 


woroz 01239 4 5 6 7 8 9 1011 12 13 14 15 


0| INDEX OF NEXT ENTRY IN CIRCULAR LIST |NEXTINLIST 


0088060 0S8 CF 6 696 OO8EE8 BOSS FOBOSSOGES ST BAS THS BD OOVOBO 


‘| — WEVe ia 
ol STARTING SECTOR OF DEVICE'S _~(NOSTARTSECTOR 
| ane VIRTUAL MEMORY REGION "| Lostarrsector 
ai w sectors INOEICE’'S rome scr 
| gf” vreTuAL menory REGION —_feout 
6] Paes DW DEVICE'S VIRTUAL nenORY {TOTAL PRGECNT 
11°F ances wwatcaid D DEVICE'S v8 (cesT aE 
REGION 
$0) © OF VALID WORDS IN DEVICE'S BIT MAP | BMLEXGTH 
11] SIZE OF SMALLEST RECENT MISS sorta 
12| SMALLEST UNGER OF PROES EVER AVAILABLE | 
an al 
20 


| 
| 
DEVICE'S VIRTUAL MERORY BIT NAP | 


REACOMMENT: A bit on in a device's VM BIT MAP 
s Correspending VN page is free. 
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Disc Layout 


Typi Priv nt 
| 0141234 5 6 7 8 91011 12 13 14 1§ 








ti SC - SCRATCH 








0| 10 INDEXED BY 
| | VOLUNE @ 
1| 1 
| VOLURE i 
a NANE 2 
31 {3 
| ovewcecese ED PPP LP OP PLL PLL LY LP LIED ILS GP PLP DED | 
4| \4 
| ] 
$| 15 
| GROUP | 
a KRNE ie 
a| \7 
| OS DD Ob DP DP BE PSPSPS IOS OSS OP SSSS SPOS SSB SSVPIESSSIO® | 
10] is 
| | 
11] 9 
i ACCOUNT { 
| id WARE he 
| 131 ]11 VN - VIRTUAL NEMORY 
| [ LOGICAL DEVICE @ =| |VAIUNINS|SC] UN - UNREADABLE/ 
| 14] (<0 IF NOT MOUNTED) | i tud gs UNFORMATTED 
| econ enewnnn |onnenennene ~--|--]--[--|--| NS - NON-SYSTEN 
} 4 VSET VTRSX | IVTRBX DOANIN 
| 15} [ 
1 [ee 
i 


Disc Layout 


Volune Table ‘ 
SIR #222226 
DST #292235 
Zero Entry 
ocfaL 0 1234 5 6 7 8 91011 12 13 14 15 DECIMAL 
WORD] -~|--f--|-- london dont eben dee bee lee dent -ol--1-- WORD 
| # OF ENTRIES (NOT | | 
0} COUNTING | ENTRY SIZE2Z16 |0 
| ZERO) | | 
| " ROLLBACK COLDLOAD 10 **See note below** : 
| NUMBER OF VOLUMES < 
i 3 ROLLBACK VIRTUAL NENCRY INTEGRITY NUMBER : 
| | meee wenn nnn nwrcwwnwerenesewnncnccowocsererseenn 
| | VOLUME SET ID £2See note belcu** | 
‘| VIRTUAL FENORY INTEGRITY NUMBER ** 
15] 143 
| enw nn wwe ene nnn wwe n nn ewww een nnenennnnewocnnone | 


| ** As of V-Delta-5 (6.03.05) the uay the COLOLOAD I0’s are 

{ used has been changed. A Volune set ID (VID) has been 

| created to logically link together a set of discs. Originally 
| the COLDLORD ID ceforned this, as well as enabling the FILE 

| SYSTEM to tell if the file was open uhen the systen failed. 

| The VID 18 NOT changed on each systen start, only on a RELOAD. 
| In order to maintain backward conpatibility, the old COLDLOAD 
| ID locations have been changed to ROLLBACK COLDLORO I0’s. The 
| actual COLDLOAD ID (for FILESYS) is in the Disc Cold Load info 
| Table (OCLT) word 46 (256). 
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Disc Layout 
Typ; A ne En 
| 012345 67 8 9 1011 12 13 14 15 
i Coed od ford Cod od ad Coot Dod Cd Cad Dead Rated ated Sate Dated Cae | 
0| 10 INDEXED BY 
| { VOLUME @ 
1} 1 
| VOLUME | 
a! NRRE : 
3} {3 
| concn enw wnewemn cen onwnnncen wn sewncenennnneeoenn | 
4] \4 
| | 
§| {5 
| 0 | 
6] \6 
| | 
4) ? 
10| STARTING SECTOR OF VOLUNE’S VA \8 
| (O IF NONE) | 
11| c 
12| NUNBER OF SECTORS RESERVED FOR \10 
Vi ON VOLUME | 
j 134 (0 IF NONE) J11 VM - VIRTUAL MENGRY 
ee oe J eoonnnnonne | --[--|--|--| SUPPORTING 
| {| UOGICAL DEVICE HW | |VMJUN|NS|SC} UN - UNRERDABLE/ 
| 14| (= 0 IF NOT MOUNTED) | i) ot bt ft UNFORMATTED 
ee Cons | ----------- |----~------ Jo-J--J--f--] NS - NON-SYSTEN 
| | |VSET VTRBX | IV TREX | DOMAIN 
15] | 113 SC - SCRATCH 


l ev aeenaeooae | sevaeeee2ooon | 20220222 OSS © COTOOODO ACO 
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CHAPTER 4 DIRECTORY Qverview of Directory 
Introduction to_the Directory 
SYSTEN 
SYSGLOB celle; 000 Primers 
/ / Nv A 
DIRBASE <----absolute dise addr of base (SYSGLOB+Z130 AND 2131) i: i ‘ ‘ 
ACCOUNTS |---| |---| 
Directory on disc consists of a contiguous area: | ! 
| pone n ene nee nee ene-| Je--| |---| 
DIRBASE -> | ) The bitmap defines the available/used / \ 
| DIRECTORY | sectors in the directory. If the / \ 
BITMAP ~ directory is < 6112 sectors, then f \ 
= ~ the bitnap will cecupy 3 sectors. / \ 
| | If the directory size is > 6112 | |--7-- | J-ceeee | 
|-eocce-wencccceene| sectors, then the bitmap will occupy | JUSERS | |GROUPS | 
DIRBASE+3 -> | | 32 sectors with DIRBASE pointing to | |-o--- | |------ | 
| DIRECTORY | the 3th sector of the bitmap. A fr. TX /\ AN 
| DAT | zero bit in the bitnap represents a / f \ / \ \ 
| | used sector. Words 0 and 1 of the l--| J--] PP Coed OE ood BU aed | 
l ENTRIES | bitnap are ignored. i iil ;/tiddd 
| AND | rill f | tot tT Groves 
| INDICES | I--1 I--1 ated A Eade at | 
| | \ / / \ 
| ; | Directory entries contain pointers ff tenet eer nn / \ 
o ~ which are sector displacenents USERS / \ 
a A ~ relative to DIRBASE. Entries and / \ 
| F | indices are grouped into “blocks”. |eeoeene | [eereere | 
| | | VSETS ! FILES | 
| coweecornennencces | exenees| © [eensess 
/ / \ 
The capacities for accounte/groups/users/files are dependent on their / / / 
block sizes. ; ' : ; / \ ' 
* SYSSAI8SIZE Systen acct index block size (3 sectors) VSETS/ | | oe on | | | FILE 
SYSRUIBSIZE Acct. user index block size (1-3 sectors) KEY: YVCLASSES | | ; ti til | | POINTERS 
SYSAGIBSIZE Acct. group index block size (1-3 sectors) [=aneSae= 1 I--t j--| I--1 Ie-l I--| 
SYSGFIBSIZE Group file index block size (2 sectors) | | / 
SYSGVSIBSIZE Group volune set definition ind. blk. size(1 sector) |--eee--- 1 tt / 
® SYSAEBSIZE Rect. entry block size (3 sectors) INDEX {--| / 
SYSUEBSIZE User entry block size (2 sectors) ENTRY FILE 
SYSGEBSIZE Group entry block size (2 sectors) 
SYSFEBSIZE File entry block size (2 sectors) 
SYSVSEBSIZE Volune set definition entry block size (1 sector) 
SYSMAXBSIZE Naxiaun of above. (used to inatialize 00S.) 
*These values are used once for the creation of the (roct) systen, 
account index or new systens. This root index is aluays at address 
DIRBRSE+3. 
6.23.00 6.23.00 
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Directory Directory 
i ata nen i ata nent n 
weenne tenn encccecccosce== (0) | --------- concwecersncerese| 
ol SECTOR |. | 275 | 1189 
5 BUFFER rs es hoe estecwerssncs| 
i 128(10) WORDS =”. | 276] 1190 
17?| { eeewweewccoroccccccncccnne 
onnenenenenncennneenenenee | 277| 191 
200 | ADJUST (08-DL) |128 | mew ene nee wenn nw nn eee onen=| 
| ooemennnnnne Scan | | 00} |192 
201] -XTYPE (INPUT PARN) [129 [een ennenrenennncnnnnnnnane| 
| eonowocennnn | eno nnenosennn | | 01] 1193 
202| | XMVTABX 11% |-coneee werwecweeweccocccce| 
| ennennonnnnn | enn encnneen==| | 02! 1194 
203] KINDEXP (FINAL [131 ———— 
! INDEX PRT) | | = ay 
aa XANANE (OB REL ADOR) 1132 | ai 196 
add XGUNARE (DB REL ADDR) 1133 | 305| 1197 
206] XFNAME (OB REL ROOR) 1134 06 | DISTRIBUTION {198 
meerorecoeocronecosenscoce | |- -| GOODPERCENT=.85 
207 | KASEC (RCCOUNT {135 07 | FACTOR 199 
| SECURITY) | | --oeeene - cneece 
| enonncenncceeweew ern coon] 310} BASE 1200 
10 939600 emer oon weenececnccccncn=| 
j- XGSEC (GROUP -| 311] [201 
411 SECURITY) [137 © CA RREA - 
come roce nn enoccecscneseens= “DDSBUSIZE 
212] SIRRETURN (FROM {138 | 
! GETSIR) | aaa at | 
213-240" sia) POINTER “139-160 \ ' i 
| eoecwnnnwnowncowccenece canal | > See Directory | WORK AREA | 
| 241-266" DIRECTORY POINTER “161-182 / Pointer Area = (SIZE OF “AX 
| ~~ a at ed LARGEST 7 
oraen-ane eens nn nneene-e--- | ENTRY) 
267| «SYS. ACCT. INDEX 1183 | ----2-------2---- 22 === | 
ots SIZE ! : 
| 270] = WEV | Py «184 _—————— nn 
coecocwenccs | -| 1145] \613 
| 271| OIRECTORY RODRESS a . 08 ARER ~DOSBWSIZE 
| 272| PRIVATE VOLUME |186 | 
! DIRECTORY SIZE | eral | 
| 273 oe 
| 274| 1188 
[een sesonessaaseseseeees --| 
6.23.00 6.23.00 
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. won creme D 


we we te ww ee oe oe - 8 omens ot eee ee . ee 


Directory 


t Pointer A Aor 0S12Z24 Rs 


°o 
om ob 


DB ADDRESS OF 1ST ELEMENT |142/164 LPNTR 


STARTING ADDRESS OF BUFFER|143/165 IOPNTR 


@ VALID PAGES IN BUFFER |144/166 NUMVALID 


o|ocee OS OE SOS 2OC4LOSSSSSSSSEBSZE 

{o| [8|145/167 D = DIRTY FLAG, 
| =|--ononnnnonnennenneeeneenne| | 8 = BAD ELENENT 
| ELEMENT SIZE [146/168 XSIZE 


| @ WORDS USED IN BLOCK 1147/1693 USED 


| BLOCK SIZE (SECTORS) [148/170 aSIZE 
| BLOCK SIZE (UOROS) 149/171 BUSIZE 


MAX @ ELERENTS/BLOCK 180/172 BFACTOR 


99 ree ee ee ee ee ee ee ee eee ewes 


}- 
[P| TY JELEMENT SIZE (BL SIZE( 151/173 AISCWD 
| | | (WORDS) | (SECTs)] 


I-1 
NUNBER OF ELENENTS 152/174 XCOUNT 
NUNBER OF ACCESSORS |153/175 PCOUNT 


ENTRY TOTAL 154/176 ETOTAL 


1-1 
0 # Ty | ENTRY SIZE (BL SIZE]155/177 ENISCUD 
{+I 


[ (WORDS) {| (SECTs)| 


FATHER INDEX POINTER 1186/178 PINDEXP 


FATHER =| FATHER (157/179 


WANE | WANE 1158/18 PNANE TY = O-FILE 

-|- -{ 1-GROUP 

| 1159/18! 2-ACCT 

-|- - 3-USER 

| 1160/182 4-VSD 

ccencenanenenan | -eeeeneren-ene=| I © O-ENTRY BLOCK 

Indexes Only 1-INDEX BLOCK 
&& Indexes and Entries P = PURGE FLAG 


ct cs re ee ee i i eee eee 
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t a RSD. on 


S2@2OG28 SSO OE S022 SOM ip We Cie Ep TE OE EE ie MES RD eh | 
TYPE OF ERROR THAT JOS’ ERROR’ TYPE 
OCCURRED 


21 


| 

| 

| 

| | 
| THIS SECTION OF THE BIT NAP | 
| OST IS OCCUPIED BY UP TO 3 | 
| SECTORS OF BIT MAP. ITIS | 
| SURPPED IN 3 SECTORS ATA | 
|] TIRE AS NEEDED. DS'FIRST* WORD] 
] IS UPDATED TO SEARCH FOR { 
| SPACE IN THE BIT MAP. WHEN | 
| IT REACHES DS’LAST'WORD FOR | 
| THE SECOND PASS, THE NEXT 3 | 
| SECTORS OF BIT MAP WILL BE | 
SWAPPED IN. 
| | 


Partial definitions: 


DS’ LEV s 0S’ BASEO. (¢ 
OS’ DIRTY = OS'FLAGS. (0 
DS'ERR’IN’PROG = eee ate 

(3 


DS’ DIR’ DISABLED = DS'FLAGS. 


8) 
1) 
1) 
1) 
DS'PERM' DISABLE = DS’ FLAGS. (3:1) 


bescripticns: 

OS’ RODR 

This is the address of the section of bit map that is currently in the 
buffers. For exanple, this addrese will usually be the sane as DS'GASE. If 
ue need to page in nore sectors of bit map than the first three, then this 
address will be subsequently larger than DS’BASE. 

DS’ BASE 

This is the base address of the directory bit nap. If the directory is 
greater than 6112 sectors, then this address will be 29 sectors less than the 
address found in the Cold Load Infornation table on disc. 

DS’ CUR’ SECTOR 

This is the current bit nap sector nunber of the first sector in the buffer 


area. Its value can range fron 1 to 30. This nunber ninus one added to 
OS’BASE will result in DS’ADOR. 


6.23.00 
4-7 


+ oo ed 


Directory 


Directory Space Data Seqnent_(DIRSOS) 


OST#21 (225) 
| SIRs8 (210) 


1111991 
0123456789012345 
l-1-t-1-1-1-1-1-1-1-1-l-i-1-t-I-! 


©} LOGICAL DEV | BIT AAP | 

" BASE SECTOR ADDRESS |0S’ BASE 

2| “POINTER TO LAST WORD [OS’ LAST’ WORD 
| IN BUFFER | 

3] POINTER TO FIRST WORD —«1DS*FIRST* WORD 
| IN BUFFER | 

4] —-SIZE_OF DIRECTORY |DS"DIR’ SIZE 
| ae IN SECTORS | 

S{OIEISIP| [OS FLAGS 

6| FIRST CURRENT SECTOR 10S* CUR’ SECTOR 
| IN BUFFER | 

7[ DISC ADDRESS OF CURRENT | 
| PART OF BIT NAP \DS* ADDR 

10] IN THE BUFFER | 


11} SIZE OF BUFFER IN WORDS  {DS’SIZE 


12] NEXT REQUESTED SECTOR {DS REQ’ SECTOR 


13] LRST SECTOR IN BIT AAP Hikesisicbinaais 
| 14] SYSTEM SAVED PTR TO LAST |0S’SYS’ LAST 


| 15| SYSTEM SAVED PTR TO FIRST |OS°SYS’ FIRST 


16] SYSTEM SRVED CURRENT |OS*S¥S*CUR 
SECTOR | 


| 
17] SAVED DIRECTORY SIZE |DS* SYS’ SIZE 


20) LOEV THAT LAST ERROR 10S’ ERROR’ LOEV 
| OCCURRED | 
| -eeewennnnnnnnnnn-nenncernnennn| 
6.23.00 
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Directory 
DS’ DIR’ OISRBLED 


If this bit is on, the directory allocation and deallocation is off and only 
a WARMSTART will turn thas bit off. The bit is turned on if an 1/0 error 
occurs on a directory bit map sector or if we find data integrity problens 
ative bit nap, i.e., if ue attenpt to deallocate a sector that is already 
deallocated. 


OS’OIR’ SIZE 


This is the size (sectors) of the directory area. This size includes only 
the last 3 sectors of the bit nap. If the directory is greater than 6112 
sectors, then this size does not include the extra 29 sectors of bit nap. It 
can also be thought of as the nunber of bits in the bit nap. 


OS’ DIRTY 


This bit is set if the bit nap sectors in the buffer have been modified in 
any way. When nore sectors must be brought into the buffers, or if we suitch 
to a different donain (systen to PV, PV to systen) this bit is interrogated 
to deternine if the sectors presently in the buffers nust be first uritten to 
disc. 


DS’ ERROR’ LOEV 
The LOEV in which the last directory error occurred. 
DS’ ERROR’ TYPE 


This uord describes the type of directory bit nap error that occurred. Its 
legal values are: 


0 - No error 

1 - 1/0 error on a urite 

2 - 1/0 error on a read 

3° poise to deallocate space 
that 18 already deallocated 

4 - Directory space nanagenent 
is already disabled 


OS’ ERR’ IN’ PROGRESS 

A directory space nanagenent error ie currently in progress. 

DS’ FIRST’ WORD 

A OST relative pointer to the word in the bit nap buffer that we uill 
interrogate next when directory epace is needed. When the systen first cones 
up, this word is aluays initialized to OS'HEADER*2 (i.e., to point to the 
first word in the bit nap). On subsequent bit nap sector reads, it is set to 


DS’HERDER since subsequent sectors will not have the 2 word overhead that 
exists in the first sector of the bit nap. 
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Directory Directory 











OS’ FLAGS . irectory structy 
This word contains nunerous flags. See individual descriptions. 
INDEX BLOCK 
DS’ LAST’ SECTOR F >| 
This is the total nunber of active bit map sectors. This nunber will range | | INDEX PREFIX = | 
fron 1 to 32. | [asheesecorsecsssese= | 
| | INDEX PREFIX =| 
DS" LAST’ WORD ! Serer eS ! 
This is the current nunber of bit nap word in the buffer. It can range fren | | eorwrenereeenor scone | 
1 to 2577 + DS’HEADER. If there exists 3 full sectors in the buffer, then | ENTRY BLOCKS 
it will have the value 2600 + OS’HERDER - 1 or 2621. It is conpared to | [eeced Jooecorernnscensernn= | 
DS’FIRST’WORD to determine if ue have hit the end of the current buffer area. ! : ENTRY ! 
DS' PERN’ DISABLE ! ! ENTRY 
If this bit is set, then directory allocation/deallecating is pernanently 1 | [ ENTRY | 
disabled. This bit should not be set. | -reeenn rere nnenn non | 
DS’ REQ’ SECTOR | | [od freeneeeeeeeneceennn=| 
JNOEX BLOCK ttt ENTRY { 
This is the next sector to begin reading in up to 3 bit nap sectors. It is [ | | [eeeeeccenneeeesenene 
updated by 2 or 3 and the read procedure will bring in up to 3 sectors | eocc con nn ne cccennnn= | till ENTRY | 
starting fron this sector. If this sector 1s set to be greater than | INDEX | | LL [rocececcenosceeenene | 
DS’ LAST’SECTOR, then it 1s reset to 1. After the sectors are read in, | BLOCK j----/ | 1 ENTRY | 
OS’CUR’SECTOR is set the OS’REQ’SECTOR. | PREFIX | A I Seteteteteteteteteteeceretetetatetetane | 
[eeresens-essesesssse | ; 1 4 ENTRY | 
OS’ SIZE | INDEX | | | Jrceerereneneceeeece- | 
| BLOCK |--<s-<- fot ENTRY | 
This is the size in words of the bit map buffer area. It is always a | ENTRY | | [reeccecercon neocon | 
nultiple of a sector (128 words). It will usually have the value of 7600. | cre enewenencowonece -| | | ENTRY | 
Legal values are 2200, 2400, and 2600. aa ! | | oenwemeeceronnenocee | 
DS’SYS’ LAST, OS’SYS’FIRST, DS’SYS’CUR, & DS'SYS’SIZE | ENTRY | The Index Block prefix points back to 
|-roe-- acecocencorena | the previous higher level. The Index 
The values of OS’ LAST'UORO, OS'FIRST’WORD, DS’CUR’SECTOR, and OS’SIZE will Block entries point to the entry blocks. 
be stored in these locations when the directory space managenent switches 
fron the systen directory to a private volune directory. And, of course, 
when DSN suitches back to systen donain, the above nenticned values are 
reinitialized with these values. 
6.23.00 6.23.00 
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Directory Directory 
Directory Definitions Index Entry (6 Yords) 
»PRGE = smallest allccatable record (“phys.recd”)-currently sector. | cooencwnwcoceccenneenscce 
>BLOCK - integral# of pages; contains contiguous indices or entries. | |O 1st NANE OF ENTRY BLOCK 
»INDEX = pointer to entry block, containing nane of ist entry. | 
>ENTRY = infornation-centaining "object" nay contain pointer to an | 1 
index block. | IE1STNANE | 
>POINTER - saa positive relative page nunber (relative to directory | : 
base). 
>BDS - directory data segnent. | 13 
»ELEMENT - a generic nane for index or entry. | poewnwo cee enennneserenace | 
IEPNTR : POINTER TO ENTRY BLOCK 
| IECOUNT |S NUMBER OF ENTRIES IN BLOCK 
Index Block Prefix (10 Words) | poeww ewww nnn nomen nn enneea| 
Q-FILE \ Account Entry (236 Uords 
| 1-GROUP| 3 BITS [cocccerenee >| INDEX SIZE (WORDS) 
| 2-ACCT |<------- \ | | 7 BITS 
| 3-USER | | | 
| 4-¥SET / | | | ----------------=---| 
| | | [---->| BLOCK SIZE (SECTORS) 0} i) 
| PURGE FLAG<---\ | | | | 4 eITS | 
| | | | ( | 11 &CCT.NARE 
| 1; | } 41919991 | RNANE | 
ee 34567890 ne 34 5, 2 2 
MISCUD mire TY ! XSIZE | BSIZE [0 INDEX BLOCK INFO. y 3 
| " XCOUNT \" NUMBER OF INDEX POINTERS ‘| AGIPNTR . ACCT.GROUP INDEX POINTER 
| Swe Sw OBS TES S426 BOS FS COLSEDOZ“BASZOSOOE 28 et O28 22 SSSS SSSOSC8E22 
" IPCOUNT 2 NUMBER OF ACCESSORS* | AUIPNTR : ACCT.USER INDEX POINTER 
{ 3| ETOTAL 13 ENTRY TOTALS i 6 16 
| |-|-Jonnne |oneee eee n--22 | ooreree | | RCAP | CAPABILITY 
ENISCUD SIO[P] Ty | E¥EIZE JEQSIZE {4 ENTRY BLOCK INFO. 7) ? 
eleleeaec- | een eeeceareceoee /] aeeneee 2882S O C8 S222 O8C22 
| 5| PInbEXP {5 INDEX POINTER OF FATHER 10] is 
| ee --- | —-ALATTR | LOCAL ATTRIBUTES 
| 6| 16 \ 11| 19 
| |- -| | [aessasesrersesssosa= | 
| 7] 17 | 12] }10 PASSUORD 
| {- PNARE -| > NAME CF FATHER | 
| 10| is | 13] 11 
| \- -| | | RPASS | 
| WI is / 14] {12 
| [asessanreassscehreeeaseeeses=se I | | 
15] 113 
2The count is increnente? by each access that uses and relies | ennnn enn nen neon nnne=| 
upon a pointer to the -adex bicck, i.e., it is guaranteed not 
to be purged while the count is not = 0. 
6.23.00 6.23.00 
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Directory 
Account En n 
| eoeenannrencnennnnn| 
16] \14 
| AOFSCCUNT | OISC FILE SPACE COUNT (SECTORS) 
| hag 
20} 116 
| ADFSLIATT fr DISC FILE SPACE LINIT (SECTORS) 
21] 
| enooeocoeencoccocree | 
22] 118 
| RCPUCOUNT | CPU TINE COUNT (SECONDS) 
a fee 
24) 120 
| RCPULIAIT | CPU TIME LIAIY (SECONDS) 
a ta 
26| {22 
{ ACONTINECOUNT | CONNECT TIME COUNT (RINUTES) 
a hie 
| |24 
| ACONTIMELINIT 5 CONNECT TIME LIMIT (MINUTES) 
1 
t-f-1-I-l-I-I-1-i-1- 
‘ioe ! | 1] | | Ld (26 FLAGS (SEE GELOU) 
| se Itelotet 127 MAX.JOB PRIORITY 
| #| COMM FILE REC [28 COMMAND FILE LOCATION OF 
: # ACCT ! ACCOUNT UDCS HARD aad 
weeesaces Seecenecan 1 
| 35] CONN FILE REC {29 COMMAND FILE LOCATION OF { | 
{ # SYS | SYSTEM UDCS (SYS ACCT ONLY) 
| i | 
| ld es pee don Dd ec od Cra Co oe Dd od | 
| ; Pl | ) RI RI Al Al wy wy LP ut Xt xX! St Si 
\-onsecul [| | JANY [AC |ANYIACIANY JAC] ANY|ACIANY JACI RNY|AC| 
ed es eed be eed bee ce De Oo od el od Doe a 
| 
FILE SECURITY 
P = PURGE flag 
S If 1, system level UDCs exist (only in “SYS” account) 
A =6If 1, account level UDCs exist for account 
E Recount Password Encrypted 
U Recount Password Required 
6.23.00 
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rou f n 
| ----ennnnnnnennnneee | 
7 GCAPABILITY 2 GROUP CAPRBILITY 
| GLINKAGE ta GROUP DIR. BASE LINKAGE 
a GVSDIPNTR te GROUP VOL SET CEFN INDX 
= GHVSNANE 126 KONE VOL SET WANE 
33| had 
x] GHV SRNANE hi (Definition’s acct nane) 
35| ie 
i 
3? | \31 
|- GHVSGNRNE -| (Definition’s group nane) 
40| hs 
41] 133 
| -eonereceroesncewes- | 
a i. 
43| |35 
l-  GHVSVSNANE -| (Defanition’s vol set nane) 
“ 136 
ai |3? 
46| GSAVEF IPNTR ]38 SAVE CELL FOR GFIPNTR 
47 GHOUNTREFCNT® 9 [39 GROUP BIND COUNTER 
a 0 hig GSPRRE 
GLINKAGE 
0 1 2 3 4 §€ 6 7 8 9§ 10 11 12 13 14 15 
eon ween wwacwowccwen cc cc nwnne ss | coc seccesecccesesecccoenrnwoscre 
[Pv | }  AvTABX 
|n-=|e-e-o--nnnnecennennennen nes [---cnee-nncneneneeennnnnnenee --| 
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Directory 


Group Entry (251 Words) 
|-encenanncennnnene==| 
0| 10 GROUP NARE 
| | 
il \1 
| GNANE { 
2| {2 
| | 
1 |? 
“| GFIPNTR i: GROUP FILE INDEX POINTER 
| Is 
6} {6 PASSWORD 
| GPASS | 
7| |? 
| | 
a : 
11| 19 OFSC FILE SPACE COUNT (SECTORS) 
| GOFSCOUNT | 
ie ia 
13] {11 DISC FILE SPACE LIMIT (SECTORS) 
| GOFSLIAIT | 
_ ig 
15| 113 CPU TIME COUNT (SECONDS) 
| GCPUCOUNT | 
al 
17| {15 CPU TINE LIAIT (SECONDS) 
| GCPULIAIT | 
"| | 
2iI 117 CONNECT TINE COUNT (MINUTES) 
| GCONTIMECOUNT | 
a tag 
23| 119 CONNECT TINE LIMIT (MINUTES) 
| GCONTIMELIAIT | 
| af i 
| 25 (P| 21 GROUP SECURITY (SEE BELOU) 
| |-]  GSEC | 
| 26] j22 
| ----a--nennnnnn-nnnaa| 
| P = PURGE FLAG 
6.23.00 
a- 14 
Directory 
nt nt 


GLINKAGE (0:1) © 0; HVS is in Systen Oonain 
(0:1) # 13 HVS is in Private Volune Donain 
(8:8) = 0; If not PV or Not Bound 
(8:8) <0; If PV and Sound 


GROUP SECURITY RASK 


o2-|--|--=|---|-==|-=-]-2=|-==|-2+]-=}-=-1--- |---| -- leo" |--*| 
PIGIRIRIRIRIRIALALAIAIAIWiNI Niu 
| JANYIAC JAL |GU IGL [ANYIAC JAL JGU JCL JANYIAC [AL (GU 


| 
JLELELIELPELIRIERTXERERESTSTSITSITS| 
26 (61 pel JAL |GU (GL JANY{AC JAL [GU (GL JANYIAC fAL [GU IGL | 


G - Group Passuord Encrypted 


File Pointer - 6 Words 


PPS DOS OP SHIP SPSTSISSE® 


| | 
| ie FILE NANE 
| FRATE \1 
| {-] | 
{81 |2 
I-| | 
i 
| FVTABINX | 14 VOL TABLE INDX / FILE LABEL 
ani -| LISC RADORESS 
FLASELADOR is 
B - Bad file label 


(0:1) 2 0 - not defective 
2 1 - defective 
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r En 19 Word 
0123456738390 ere 














| 
| J-l-fed-l-l-tel-d-l-tel- 
| ol JO USER NANE 
| 1| UNRME \1 
| Z| ; j2 
, 3 j 
j 4| 4 CRPRBILITY 
| | UCcAP | 
a ° 
| 6| 16 LOCAL ATTRIBUTES 
| | ULATTR | 
| 7| \7 
| | eonnnenenno nnn enccenennennnnen=| 
| 10] 18 PASSWORD 
| 11] UPASS 19 
| 12] }10 
“| 
| 112 HONE GROUP (MAY BE BLANKS) 
| 15| UHGROUP \13 
| 16| 14 _ 
| 17] 115 / LOG CNT (# OF USERS 
| | owen nen co wenn wnnwwnennsocooorn= | | UWGGED ON). INIT TO 1 
| 20| ULOGCOUNT 116< FOR MANAGER.SYS SO THIS 
| l-|-1-I-[-]-|---|-----eeenn-----]  \_USER CANNOT BE PURGED. 
URAXJOBU sa aa a JOBPRI j17? AAX. JOB PRI 
| 22| COMM FILE REC 3 \18 
| | (COMMAND FILE LOC OF | 
| | USER UOC’S) | 
| eee oad | 
| P = PURGE FLAG 
U = UDC EXIST FLAG 
E = USER PASSWORD ENCRYPTED 
R = USER PASSWORD REQUIRED 
X = USER PASSWORD EXPIRED 
W 2 USER PASSWORD WARNED FOR EXPIRED 
6.23.00 
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Directory 
Volune finition En 
| 012345 67 8 9 1011 12 13 14 15 
|--|--|--J--]-=|-=|--|--1--1-- lb ee f--l--I--1--] 
1| 11 VOLWKE 
2i GVSNANE j2 SET 
| jo] | ° ne 
TY # 0 ga A] | INTRBX 14 GVSLINKRGE 
5] VOL COUNT | VRASK : GVSINFO 
/ 6 16 MEMBER VOL. 
| 7{ |? WANE(1ST 
VOLUNE 10] GVSVOLUME {8 ENTRY IS 
ENTRY O < 11 {9 MASTER VOL) 
(6 WORDS) | [ocorenneennonnnnnnnnn= |--| 
i dh GVSVOLF LAGS 
{ svoeucseseeceoen re oe 
ae PSEUDO SUBTYPE VTREX he GVSVOLIKNFO 
/14| \12 
I. | ‘ 1. 
VOLUNE |. . P 
ENTRIES < e = e . e 
1 . ? |. | e | ° 
a (a7 
“a ‘ia 
yi fag 
62] GVSVOLUNE 150 NEN. VOL. 
| | NAME 
a ss 
| GVSVOLFLAGS (MEMBER VOLUME FLAGS) i 
a GVSVOLINFO (MERBER VOLUNE INFO) |53 
66] GVSOREFCNT (OEFN. REF. CNTR.) 
67| 0 ISS SPARE 
| oe neem nenmennn anne nnnnoncnen nnn n cnn wennneenn= | 
| TY¥ = 0: Volune Set Definition VIABK: Volure Table Index 
21; Volune Class VOL COUNT: Wo. of Volunes 


MVTRBX: flounted Volune Table Index (If Mounted) 
| VMASK: Volune Mask 
{| 20: Not nounted 
| 21s: Mounted 
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Directory 


User Attrjbutes/Capabrlities 





FILE-ACCESS ATTRIBUTES__/~ SAVE FILES ------- 
\_NOK-SHARABLE DEVICES--\ 
/ CONMUNICATIONS--------- \ 


MODE MANAGER-------- 


\ 
| 
i | 
| Vill 
| NETUORK ADMINISTRATOR----\ | | | | 
rr SYSTEM AGR Pioudl 
oe ACCOUNT NGR plbaudtd 
| | | fece-ceeeeeACCOUNT LIBRN 6] 6] UI UO 
USER / | | | [reeceee GROUP LIBRN i ’tt ed 
AttR< | | {| | /eee-OrRGNOSTICIAN 86| | 1 tod 
‘tot ot dst /-Systen supvsR | | I od if 
i; }otbtebot createvos | | tt | 
1 i bd bt fb Pt USé vous plyddl 
;detdeteb tot C user voccinc ) | 1 ot 
1 |tEbeL Lb 2 & § | SYSTEn PROCESS HANOLING 
LI tf td ft Pot ft to) PROGRAMMATIC SESSIONS 
Lhe Pobre wd. 
J--]--[--[--|--]--1--1--1--1--l--}--f--1--1--1-- 
(SMJAMPALIGLIOI{OP ICV UVILGISP|PS|NAINA|CSIND| SFI 
J--|--|--}--L--]--1--1--f--1--l-el--t--1--1--1--1 
01234 5 6 7 8 91011 12 13 14 15 
ed Peed od Fed eed ord ed ad ed Od od ed ated ed 
, yet dt Ut (Batrajeny | TARE = [OSTPH| 
|--|--|--|--|----}--1--1-- |--1--1--1--1--l--l-od 
| | | i | 
BATCH ACCESS -/ | | | it 
INTERACTIVE ACCESS ----/ | | 1 | 
ae | PRIVILEGED MODE ------- / ! 
< 
GENERAL | MULTIPLE RINS -------------- --/ | 
RESOURCES| EXTRA DATA SEGHENT -------------------- --{ | 
\_ PROCESS HANDLING -----------------------"- / 
6.23.00 
4- 18 
Directory 
] NK A 
0 1 | 23 4 5 6 7? 8 9 10 11 12 413 14 15 
;7riat NOT | IVTRBX | 
i ft | USED | \ 
[ane | mon [penne n nnn n nnn nnn nnnnnnn | enn nme w owen nennenennnewsneoor=| 
T - TYPE 


0 ® Volune Set Definition 
1 = Volune Set Class 
A - ALLOCATING FLAG 
0 © not initially allocating (not Ist user of set) 
1 = 1st user of set allocating resources (transitional) 
MVTRBX - Mounted Volune Table Index 
© if volune set not logically nounted 


v NF 


SOOO Ce BAS SOGSS | O22 280888 C84 6 | OS 6 O8 O46 O28 £ OS SOF O8 LOS DHSS ODOSOO® 


VOLCNT - Nunber of nenbers in set 
VSMASK - Bit nask of volune nenber usage 
Order is fron right to left 
i.e., bit 15 is Ist member, bit 14 is end nenbder ... 
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et 





Directory 
vVSV¥ a 
012 3 4 § 6 7 8 ¥ 10 14 12 13 14 2 
| NOT USED iat 
| { | 
|------ne-nnnne= wovnnnceenanaenen== wonwaneerenenncerennaane| == | 
Mh - Renber Mounted Flag 
0 = not mounted 
1 2 mounted 
VSYV NF 
' 0412 3 4 § 6 ? 8 9 10 11 12 139 14 15 
| DISC | VTRBEX | 
! PSEUDO SUBTYPE | 
DISC PSEUDO-SUBTYPE = (Actual type *16) ¢ actual subtype. 
VTABX - Volune Table Index 
6.23.00 
a- 21 
Directory 
GSYVCLINKAGCE 


012 3 4 § 6 7 8 ¥§ 10 11 12 13 14 18 


| ooo | aee | SOS 0 OSO9S OC BS C828 OSS OS FS OBS S9S9SS9G9SSES SSE SSSESS8SSHOCSSS8O 


(Tt ff | 


| eco | aee | S928 OSC OS 6 6 OS OSS O98 OOS S89998 2288 SOEEE448 OE24 BSSSSSSSSSESTSOESO | 


T - TYPE 
1 ® Volune Set Definition 
O = Volune Set Class 


EVCINEO 


= 1623 4 5 6 7 8 9 10 11 12 13 14 15 
}  vOLCNT | = NOT VCRRSK 
 : | USED | 





VOLCNT - Munber of nenters in set 

VCNASK - Bit nask of volune nenber usage (VOLUME CLASS MASK) 
Order ie fron right to left 
i.e., bit 15 is 1st nenber, bit 14 ie 2nd nenber ... 


6.23.00 
4- 23 


° 
- cm er ee eee ee SS a a Ke Kon 


Directory 


Volune Set Class En 


1,149 1 
| a af a hd pea 
Pe aa (0 VOLUME CLASS NANE 
- -| 
1] {1 
|- GVCNANE -| 
2| j2 
|- -| 
3 
4| GYCLINKAGE 4 VOLUNE CLASS IDENTIFICATION 
ene eo aoe 
5| GVCINFO {5 VOLUME CLASS INFORMATION 
| none ene nnn nn we nnn wenn es eennnne | 
6| GVCPNANE fy PARENT VOLUME SET DEFINITION 
7| \7 
|- GVCPANANE -| ACCOUNT OF PARENT DEFINITION 
10| : 
11] 19 
| poeen nnn ee nnn nn nn nn nwennnn nn ece | 
12] 110 
|- -| 
13] (14 
|- GVCPGNARE -| GROUP OF PARENT DEFINITION 
“| j12 
id 113 
is \14 
174 j1§ 
|- GVCPVSNANE -| VSNAME OF PARENT DEFINITION 
20| AL 
21] i" 
af 0 Iss 
23| 0 \19 
| eeceneewernercenewnsnwnnnnenone | 
| WO UR a A EM GE ED OH TE Se a a a 
67| 0 (ss 
| eemawew nnn enw w wen mnnmeecnerone 
6.23.00 
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Directory 
Yolune Ragk Fornat 


- USED IN AVTAB, PVUSER, FILE CONTROL BLOCK (FCB), 
rie DEFINITION, VOLUME SET VTRB. 
=. ~| K. 





TD) PEED ED ALPES LIED DADE DEE LD Sd ED PEDAL SP PES aD a 


| v7 | V6 | vS | v4 [v3 | v2 | v1 | WO f 


CVO SNOS OF VFB FSO SF SH885G SS 8 OSS SHSVSVVSSSOTS 
n a a na ~ a 


| 
\- VOLUME © (MASTER) 


\-a--c---2-- VOLUNE 2 
woncnnencncmno== VOLUME 3 
\-n—-n-n---nn-nnnennna= VOLUME 4 
=--- VOLUNE 5 


| 
| 
| 
| 
t 
| 
| 
\ 


2D GE cD Gee ER a i a SS 
2S OS ES SE GS A ED TS 


[seeceneerewoen 





Sp GSD Gan cE ED GE a GEG a ee > 


| 
l 
| 
| 
| 
| 
| 
| 
| 
i 
\ 


0888880888800 COT OSO SCOOT OEBOSO VOLUME 6 


(ceecewecwncerencecccccccccncncocccos VOLUME 7 


0: NOT MOUNTED OR NON-RENGER 1: AMOUNTED OR MENGER 
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Lock Resources 


HAPTER CK_RESOURC 


R#&A ation OST 25 


SIRs Ordered by SIR Nunber 
SIR # RANK SIR NAME 
1 10 LORD PROCESS 
2 335 CACHE CONTROL 
3 91 100 
4 §2 coo 
5 50 PROCESS TREE STRUCTURE 
6 & SCHEDULING QUEUE 
7 70 CST ENTRIES 
8 6) SYSTEN DIRECTORY 
§ 90 LPOT 
10 85 LOT 
11 110 STORAGE IN OVERLAY AREA 
13 1X0 JPCNT 
14 140 JCUT 
1§ 2? JNAT 
16 5 FRRVT 
17 22 LORDER SEGHENT TREBLE 
18 18 voo 
193 190 SPOOL 
2 200 MESSAGE CATALOGUE 
21 210 RIT 
22 220 VOLUNE TABLE 
23 2X0 WELCONE MESSAGE SIR 
24 240 ASSOCIATION TABLE 
25 2 CS ALLOCATE 
26 200 LOGGING BUFFER 
27 $3 PV IVTRB 
28 280 REASSIR 
29 290 PV USER TABLE 
xd 3x0 IMAGE 
31 310 KSAN 
32 320 USER LOGGING 
33 30 DEBUG BREAKPOINT TRBLE 
4 x0 PcB 
35 3 SUB-QUEVE MAPPING TRBLE 
36 360 CILOG 
37 2 FILE INTEGRITY 
38 380 RIN 
39 390 TRPE LABELS 
49 87 DEVICE CLASS TRBLE 
41 40 Reserved 
42 401 Cold Load SIR 
43 1st JO8 
44 2nd J08 
6.23.00 
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Lock Resources 


SIR Table Infornaticn 


The systen internal resource table is located in non-linked nenory (resident 
table). The SIR table is used to protect critical systen elenents against 
access by nore than one process, i.e., it provides a "lock out” nechanisn. 
Each critical systen resource (usually a table) is assigned a specific SIR 
nunber. Procedures are provided within NPE to lock (GETSIR) and unlock 
(RELSIR) the SIR. Processes attenpting to obtain a SIR that is not available 
are inpeded by the systen. The SIR table entries forn the head of a linked 
list in this case. If nore than one process becones inpeded, word 17/18 of 
the PCB entry ie used to add the “neu” process to the growing list. The 
nethod of uninpeding the process depends on the SIR type. 


A SIR does not respect process priority and operates in a FIFO nanner. When 
a process is added to the end of the queue, the priority of the holder of the 
SIR and the priority of all intervening processes are increased. They are 
increased to the priority of the newly requesting process. 


To get SIRs, arrange the SIRs in secending order by rank. To release SIRs 
arrange the SIRs in descending order by rank. For exanple: 


Get SIRs Release SIRs 


GETSIR (LOT) **Rank=85%* RELSIR (000) **Rank=92** 
GETSIR (000) **Rank=92** RELSIR (LOT) **Rank=85** 
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Lock Resources 


SIRs Ordered by Ranking 


RANK SIR # SIR MANE 
§ 16 FRAVT 
10 1 LOAD PROCESS 
22 7 LOADER SEGHENT TABLE 
rd.) 37 FILE INTEGRITY 
27 1§ JMAT 
it] 5 PROCESS TREE STRUCTURE 
& 6 SCHEDULING QUEUE 
70 ? CST ENTRIES 
80 8 SYSTEM DIRECTORY 
83 27 PY FNTRE 
85 10 LOT 
8? a DEVICE CLASS TRBLE 
90 9 LPOT 
91 3 100 
92 4 ood 
110 1 STORAGE IN OVERLAY RREA 
1% 13 JPCNT 
140 14 JCuT 
18 18 yoo 
19 19 SPOOK 
200 20 MESSAGE CATALOG 
210 21 RIT 
220 22 VOLUME TRBLE 
230 23 WELCOME MESSAGE 
240 24 ASSOCIATION TABLE 
2 25 CS ALLOCATE 
260 26 LOGGING BUFFER 
280 28 REASSIR 
290 23 PV USER TABLE 
x0 K ¢) IMAGE 
310 31 KSAA 
320 32 USER LOGGING 
330 33 DEBUG BRERKPOINT TABLE 
335 2 CACHE CONTROL 
340 Ko] PCB 
30 35 SUB-QUEUE RAPPING TABLE 
360 36 CILOG 
380 38 RIN 
390 39 TRPE LABELS 
400 Ai Reserved 
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Lock Resources 


R En Forna 


345 6 7 8 9 10 11 12 13 14 15 

















| 0 jo free 

| 0 ‘ (not locked) 

| 0 \2 

[crore rtensecoce ween enon nnn cnc cconoccccnwcennnan| 

| 0 |3 

|-- SSS eee: Ltd conecrowseoerecsenes | 

| enon nnn nnn nnn nn nee nn nnn none nneenecennnennnnces| 

| PCB INDEX OF HOLDER 10 —s SIR locked 

0 1 (no inpeded processes) 
| 0 j@ 

| 0 13 

| peeeeewn nnn nnn enn nn nnne nen nnnnnennnnerececenene| 
|-----ennenn-nnenn--oo- 

| PCB INDEX OF HOLDER io SIR locked 

i SIR QUEUE LENGTH i (inpeded processes) 
HEAD OF IMPEDED LIST (PCB RELATIVE) 2 

| TAIL OF IMPEDED LIST (PCB RELATIVE) {3 


288 S9 OO C 9S 28208 82OS8SS8S8SSSES88E8 O88 





P = PIN ® 
PIN = PCB table entry nunder 
SIR QUEUE LENGTH - nunber of processes queued for this SIR 


The SIR table is indexed by SIRW, uith each SIRM corresponding to 3 unique, 
preassigned systen internal resource. Entry # 18 not used. Inpeded lists 
are established by using the SIR table entry (2) as the head of the list and 
Aare ree elenents. PINs are aluays used as pointers, with 0 indicating 
end of list. 
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Lock Resources 


RIN Ta ca u nitialized 

| 01234 5 6 7 8 91011 12 13 14 1§ 
| OST = 226 Jo-J-=l--1-= fee] --1--l--1-- l= bee leet -- beet --1--| 
| INDEX OF FIRST FREE ENTRY le 

| ccees wesw ww cnns seccceoune aw vecsessoooorsacesce 
[ccocreesee ~=< | (® LOCAL + GLOBAL RINS) * 3 | 
| [aeseemes see emn see ner rennet te sera ee 
| | | | 
| J nn | oo | once ne nen nen enocnn con cwn cnn nwnnweecone= o|<oo/ FIRST 
| | et | INDEX OF NEXT FREE jr--\ FREE 
| ] oo | on | ene e ner n cower ne sen en snrcenneneon coenecen | | ENTRY 
|RT = RIN TYPE| 0 l 
| (WHEN | eoccewwennnwecooeccece woeerccconcsavcs socecece-| | 
j ALLOWED) | 0 | 
| |-=|==|-----2--no-nreee-2" onnvennnnneneo one on--|e--/ 
| [| Rt | INDEX OF NEXT FREE | >--\ 
11 = LOCAL RIN|-2|o-|-nnn-neonnnnennnnen nnn ne= weowoscocccnccce i | 
{2 - GLOBAL | 0 oe | 
| RIN | erocenccnennenwereccccencnwceenccesnncccccocees| — | 
|3 - FILE RIN | 0 ; | 
! [paseeeesseosewersseaa sere ae= Sea reeeseoneress 1 | 
| \ 1 | 
| 2 - |. 
| |. 
| | | | 
| Joe fon | econ enon nonnteorocennnwewcwonerecwcnnnenes | | LAST 
| ! RT | O(EOL) \<--/ FREE 
| | 
| { 
l | 
| 























we | an | oennnenenncccewenwneweenwnennnnecosenccee| ENTRY 
0 | 
SSS COS CC S8ES CO OS88S2SSE8ESFEE428 944 2OGS2EE 89SESESEE8EE6808 | 
| : | 
\-nnnecoccee=>| FREE LIST POINTER | pono 
SECONDARY | ennnercnrennrccwcerwrcwennnenewscesecesnosacoce| | 
TABLE OF 12- | TOTAL @ OF ENTRIES | | 
WORD ENTRIES | ---nn enn cen nnn nnn ewnnnonnecoecoennecccceecnnne=| j 
FOR GLOBAL | NUMBER FREE ENTRIES | | 
RIN’S ONLY | een n nn ann nen nnn nnn en nenen crown snwenenewcnenene | | 
RESERVED ! 
l JIN Ol IF FREE, PTR TO | lO<--/ 
| i NEXT FREE | | 
| ] | reenonewenenenocewencoece| iN 
LENGTH = 
# ALLOCATED 
GLOBAL RINS 
| | = 12 110 
| \l/ 13] 11 
6.23.00 
§- 5 
Lock Rescurces 
k f Fj 
| OST 226 
RIN TABLE 
| 01234 85 67 8 910 11 12 13 14 1§ 
} J--|--Joo]--l-=]-=|--1--1--f--f-- l-- toed} -- 1-1 
INDEX OF FIRST FREE ENTRY 
(NUMBER OF LOCAL + GLOBAL RINS) * 3 
| | 
| eweceen wen eeneecccecenccoe=| 
| | 
| | 
| 
| 
| 
( | 
| | 
oeoe- | ESR Ee te aE AS GEES Hh Te AS GE SE ES | 
11 4 | 
en OF FOLD meccecenoneocenoses | 
| PIN OF HOLDER | 
HERD OF WAITING LIST (P) i 


| 

| 

| 

| | 
| 
\-> PCB @ uaiting processes PCB @ process <-/ 
linked through PC8 that “holds” 
inpeded queue RIN 


| P = PIN ® 
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Lock Resources 


Allecation and kina of a] RIN 


OST 226 
RIN TABLE 
123.4 5 6 7 8 91011 12 13 14 15 


eg ds fed dd eg ed ad od do ad 
| INDEX OF FIRST FREE ENTRY 


JOB 
INFOR- = |----- | eewnnn nnn e comme nnn enn nnn nen n enone neresen= } LOCAL 
naTION 610 1] INDEX OF NEXT RIN J--\RIN #1 
TABLE wooee | poce cw ee enn nen memnenrnnnoccconncoccces = iAultaene) 
(JIT) =| | 
J-----| | ; | 
| i | 1 | 
1] | | 
| |#43| | | 
----- |neona| -onwnnnnnnnrnnnnnnnneoennnnn no eenenenene=|<-/LOCAL 
[LOCK |-->f 0 1] INDEX OF NEXT RIN |--\RIN #2 
JRIN | = Jenene | eowenceewennn men nnn nnn nneonnn enn cceennonn | | (UNLOCKED) 
INDEX| | 14 
Jocnn-] [eeceeenneeee wreenccrencecc renew nennenmenoecece 1 | 
i | 
| oorewc ener ennnnnsece wococorcococencce cowcccscee| | 
| 1 f 
| ; | 
| \ | 
[enon | -neenennenenenwnrorneneen nen wocenenenene=|c-/ LOCAL 
fo 1 © END OF LIST |} RIN @3 
|----- | eee mnn nen en nm ec wenn wenn encoenswncnne ccoe| (LAST) 
| PIN OF HOLDER (P) aoe 
f--| HEAD OF WAITING LIST 


| 

| 

| 

| 
->PCB # waiting processes -/ 
linked through 


PCB inpeded queue 
(PCB # pointers) 


PCB ®@ of process < 
that “holds” RIN 








OOO 6 00 6 OO 80 © 0888 C8 OOOO O2OSSOSSSSSSTOSSSSTSSSEOOOSO 


| P = PIN® 
6.23.00 
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Lock Resources 
Allocation and kina of RIN 
| OST X26 
RIN TABLE 
| 345 6 7 8 9 10 11 12 13 14 15 
| Jo |--|-=|-=]--1--1--1--1-- 1-1-1 “1-1 --l--| 
INDEX OF FIRST FREE ENTRY 
(NUMBER OF LOCAL + GLOBAL RINS) * 3 | 
a | 
| | 
i 
| 10 | INDEX OF PASSUORD, USERNANE a, 
| PIN OF HOLDER a 
mt HERD OF WAITING LIST (P) 
| { } 
v | | 
PCB @ PCB @ 
waiting { process | 
processe { that | 
- “holds” | 
"RIN 
| 
| 
| 
/ 


RIN PASSUORD 


0S © © COS O 6 6 08808 OOO SSO2S8SSSS GSES SHESSS2808 


USERNAME 
(USER NAME AND ACCOUNT) 


© 2S SO BOSE 6 920 6 62 SLOSS SSSSOESS8SES8E 





| 
| 
| 
| 
+] 
| 
| 
| 
| 
| 
( 
| 
| 
| 
| 
| 
| 
| 


P= PIN 
INDEX OF PRSSWORD = ae TO BASE OF SECONDARY 
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File Systen 


CHAPTER 6 FILE SYSTER 


File Systen Overview 


This chapter describes the NPE V file systen, including the basic concepts 
and the table structures used. 


1/0 to files is done by reference to file nunbers, uhich are assigned by 
calling the FOPEN intrinsic. This establishes an initial “point of 
attachnent", which may be described as a connection between a progran (i.e., 
process) and that particular point in a particular fale at which the next 
FREAD or FURITE would cause data to be transferred. A point of attachnent is 
described by a control block, of which there are several different kinds 
(described later in this chapter). Control blocks may exist in the process's 
oun stack or in an extra data segnent assigned by the file systen. In order 
to find control blocks quickly, a pointer schene called vectors is used. A 
control block is uniquely described by a vector, which consists of tuo words 
with the first word containing a segnent nunber and the second uord 
containing a uord offaet into the control table of the vector table entry 
which describes the location of the control block within that segnent. The 
entire assenblage, consisting of eight overhead uords, the vector table, and 
all of the contro] blocks to uhich it points, comprises the entire segnent; 
if in a stack, it occupies part of the PXFILE part of the PCBX. 


The point of attachnent is described by a “physical access control block", or 
PRCB, which will exist as a result of an FOPEN to any file (except SNULL). 
Any required I/0 buffers are associated with the PACB. 


All FOPENs specifying "nulti-access" for all processes running under a single 
job use a single PRCB for references to a nulti-access file. fAithough all 
these are attached to a single point in the file, the type of attachnent 
(i.e., AOPTIONS) nay be different. Therefore, each FOPEN specifying a 
nulti-access file establishes a "logical access control block", or LACS, 
uhich contains the point-of-attachnent local values. The use of a single 
buffer (i.e., PACB) ensures that references by various processes or against 
various FOPENs within one process are dealt with in strict sequential order. 
Note that references to a file by other jobs, or by other processes not 
specifying nulti-access, will be through other PRCBs, whose buffers will be 
read or uritten at the pleasure of the file systen; in order to ensure any 
sort of coherence to such shared references, the jobs nust use global RINS 
and FLOCK and FUNLOCK the file. SSTDIN, SSTOLIST, and spoolfiles are opened 
nulti-access automatically. 


In the case of disc files, there is another kind of control block: the file 
control bleck (FCB). It contains copies of infornation read fron the file 
label, such as the end-of-file pointer, the extent nap, and the record and 
block structure. The EOF pointer is updated in the FCB as the file is 
written, and all changes nade to the FCB are posted to the file label uhen 
the file is closed. fn FCB is shared by all jobs in the systen which 
reference the file. 


6.23.00 
6- 1 


File Systen 


Table Fornats 


Below is a detailed discussion of the main tables constructed and used by the 
file systen. The location and overall structure of each table is given, in 
addition to the table fornat and a discussion of each field in the table. 
Table indices at the right of the table are in octal. Index nanes apply to 
the entire word; if in parentheses, the nanes are defined in the file systen 
listing but not explicitly used there. 


File Systen Section of PCBX (PRETLE) 


The PXFILE area is a subsection of the PCBX. It is a contiguous, expandable 
and contractible block of storaae that is managed by the file systen 
prinarily for its oun use. Other subsystens, nanely CS and OS, also nake use 
of the PXFILE section. In doing so they must conforn to the conventions of 
the file systen. 


The overall structure of the PXFILE area is: 


OVERHERD eae 
wow ccnewccere seen eone <n | 


| 
CONTPOL BLOCK | (VARIABLE) 
TABLE | 


| 
RVRILABLE ata) 
aaa | 
| ACTIVE FILE | (VARIABLE) 
| TABLE { 
| {DL-5 
Joonen cen erennrewennnne | 
G.23.00 
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File Systen 


The file nunber assigned by an FOPEN is an index into the Available File 
Table (RFT), a table of six-word entries which 18 at the end of the PXFILE 
part of the PCBX. Two double words are vectors to the PACB and (af at 
exists) the LACE. 


RFT entries can also reside in a global AFT extra data segrent. If the file 
was opened Global AFT (specified in the AOPTIONS) and the progran is 
privileged, then the AFT 18 placed anto this global AFT DST. Any accesses to 
the file are identical to local AFTs. All accesses to the file cpened global 
nust be done fron privilege node code. The file systen intrinsics 
distinguish this file by a negative file nunber. Again, these files are 
identical in every other way except for where the AFT entry resides. 


Because control blocks are shared among processes, it is necessary to have a 
schene for coordinating access to then. A control block is “locked” by a 
process which requires exclusive access to 1t for a tine. Other processes 
uhich attenpt to lock the block wall find it already locked, and will be 
impeded and queued. It nay also be necessary to lock an entire control block 
table so that a process can create or destroy a control block in it, or lock 
or unleck an existing control block in the table. 


Rnother table used by FOPEN is the File Multi-Rccess Vector Table (FRAVT). 
This table exists in a systen extra data segnent and 1s used by all jobs end 
processes in the systen. When a file is being FOPENed uth nulti-access 
specified, the FNAVT 18 searched; if the file as already open, the FHAVT 
gives the PACB vector for the prior reference for each job. 


ffers 


A bit in AOPTIGNS specifies, when a file is opened, uhether access is to be 
buffered or unbuffered. If unbuffered, data is transferred directly betueen 
the 1/0 device and the user’s buffer (usually in his stack), which will be 
frozen in menory for the duraticn of the transfer. If buffered, the data is 
noved between the user’s buffer and a file systen buffer to which the I/0 is 
actually done. 


Buffers are associated with the PACD, attached to it as an appendage. 
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verhea 


The part labeled Overhead contains information that pertains to the entire 
secticn. It is addressed via the pointer at DL-3. 


1234 5 6 7 8 $9 10 11 12 13 14 15 


O| PXFILE SIZE IN WORDS {0 PHFSIZE 

11 LAST DOPEN ERROR KO. | LAST COPEN ERROR KO. [1 

iv Bee eee eter 

Vue 

‘carne 

| LAST KOPEN ERROR NO. | LAST FOPEN ERROR WO. (5 

6| AFT SIZE IN WORDS 1g PXRFTSIZE 
|7 


- CS TRACE FILE INFO | (PXCTRINFO) 


S89 O9S6OSOE 8 O2GOSE4 24 ©O8S8424 SESVSSSESOESSESCSESBAAOSGOSCS 


| 
| 18 

"| LAST RESPONDING NO-UAIT I/O AFT ENTRY NUMBER |9 PXFLEFTOFF 
| 


| | 9299222020288 8S08 ©0828 S2E28020 | 2208S CO9O8 C8828 2OE8O8Of2O228 | 


12{ 1ST USER (NOSUF) CONTROL BLOCK TRBLE OST NO. [10 PXFCBTI 
131 ano USER (MOBUF) CONTROL BLOCK TROLE OST NO. [11 (PXFCBI2) 
14| 38D USER (NOBUF) CONTROL BLOCK TABLE OST WO. [12  (PKFCBT3) 
15{ ATW USER (NOBUF) CONTROL BLOCK TABLE DST WO. [13 (PXFCBTS) 
| 161 SiH USER (NOBUF) CONTROL BLOCK TABLE DST NO. [14 (PKFCBTS) 
| 171” GrH USER (NOBUF) CONTROL BLOCK TABLE DST NO. [1S (PKFCETS) 
| 20] 71H USER (ROBUF) CONTROL BLOCK TABLE OST NO. [16 (PxFCB17) 
| ost arn USER (HOBUF) CONTROL BLOCK TABLE OST NO. 
i | 


8TH USER (NOBUF) CONTROL BLOCK TREBLE DST NO. ve (PXFCBT8) 


Partial uord field identifiers are: 


PXFOOPEN s PXFILE(1).(0:8)@, last OOPEN error code 
PXFCOPEN = PXFILE(1).(8:8)8, last COPEN error code 
PXFNOCE = PXFILE(2).(0:1)@, no CBs in PXFILE COT? 
PXFKOPEN = PXFILE(5).(0:8)#, Laet KOPEN error c-de 
PXFFOPEN = PXFILE(5).(8:8)8, last FOPEN error code 
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Discussicn: 
PXFAFTSIZE 


PXFCBT1-8 


PXFCOPEN 


PXFCTRINFO 


PXFDOPEN 


PXFOSINFO 


PXFFOPEN 


PXFKOPEN 


PXF LEFTOFF 


PXFNOCB 


PXFSIZE 


Active Fi 


File Systen 


This is the size (in words) of the Retive File Table (AFT). 
The size is in words to simplify calculating the size of 
the available bleck. 


These are the OST nunbers of the user (NOBUF) control block 
tables. A DST nunder of 0 indicates that no data segnent 
is allocated. 


This contains the last COPEN error nunber. Not used by the 
file eysten. 


This contains infornation pertinent to the CS trace file. 
Not used by the file systen. 


This contains the last OOPEN error nunber. Not used by the 
file systen. 


Reserved for 0S. Mot used by the file systen. 


This contains the last FOPEN error nunbder. If it is zero 
then the last FOPEN successfully conpleted; otherwise the 
last FOPEN was unsuccessful and the nunber is the file 
systen error nunber. 


This contains the last KOPEN error nunber. KSAN is partly 
enbedded in the file systen, and an FOPEN failure on a KSAM 
file can be caused by a failure to open either the key file 
or the data file. This error nunber is used in conjunction 
with PXFFOPEN to deternine which file caused the KSAN cpen 
failure. This error nunber is not used by the file systen. 


This is the AFT entry nunber of the last file/line that 
conpleted a ncusit 1/0; if zero then no nowait 1/0 has been 
conpleted. This cell is maintained solely by and for the 
IOUAIT intrinsic. 


This bit signifies that control blocks are not to be 
created in the PXFILE control block table. This bit is set 
by the NOCB paraneter to the CREATE intransic or the :RUN 
connand. This feature pernits the user to have as nuch 
etack space as possible; otheruise the file systen will 
take several hundred words of etack for the PXFILE control 
block table. 


This is the size (in words) of the complete PXFILE area. 


It is the sun of the overhead block, the control block 
table, the active file table and the available block. 
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Table (RFT 


The part labeled Active File Table contains infornation used by the file 


systen (or CS, 


OS, etc.) to grossly characterize the file access and, nest 


inportantly, to give the location of the control blocks. 


The overall structure of the AFT is: 


| 

| ENTRY WN iam 6 WORDS) 
|-----0nn+---nneenenenee | 

; | 

ics | 

I 4 
oo 

| {DL-10 

| ENTRY 1 | (FIXED) 

| JOL-5 


Where N © PXFAFTSTZE / 6. 


The length of the AFT is specified by PXFAFISIZE. Unused entries are all 
zeros. Uhen the table is full it is expanded by taking space fron the 


Available block. 


The AFT is negatively indexed by file nunber: the entry at OL-10 corresponds 
to file nunber 1, the entry at DL-16 corresponds to file nunber 2, etc. 


The structure of the giobal AFT OST is ae folleues: 


| DB + 0 
! ENTRY 0, NOT USED 

Joo ene nee e nen ceeeone ---| 

[08 + 6 

| ENTRY 1 
oa ! 

| eco nn wenn nce nececennne| 

| 108 « (WN * 6) 
| ENTRY WN 


File Systen 
PXFT fn k Table (PXFCBT 


Addressing within a PXFILE control block table is sonewhat nore conplicated 
than addressing an extra data segnent CBT since the table does not begin at 
0B+O. As a result all pointers within the table are table relative; the 
starting address of the table nust be added to 3 pointer to generate a final 
OB-relative address. This addressing convention as consistently applied to 
all control block tables. 


When the control block table ie expanded, space is taken fron the AVAILABLE 
area. If no space is available then the PXFILE area 1s expanded and the 
acquired space is added to the AVAILABLE area. 


Availab k 


The part labeled AVAILABLE is used to provide space when the Control Block 
Table or the Retive File Table is expanded. These two tables grow towards 
each other, and when more space 1s needed it is sinply taken fron the 
AVAILABLE Block. 


Uhen the AVAILABLE area is exhausted, the PXFILE area is expanded, the AFT is 
relocated and the new space is added to the AVAILABLE Block. 


Currently the PXFILE area is only expanded; it is never contracted. 
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The structure of a file syeten RFT entry is: 


123 4 5 6 7 8 9 10 11 12 13 14 15 
[=n |==|~=]==|=-[-=]-=1=-1-=1-=1--I-=1-=1-=1--1-=I 
| ENTRY TYPE] Nj 


Re ee ico lance | oa 

| PHYSICAL ACB ENTRY ADDRESS 12 AFTPRCBENTRY_/ VECTOR 

a ae 
it LOGICAL RCB ENTRY ROORESS [4 RFTLACBENTRY_/ VECTOR 
| | wocwntT 170 100K SSS TOON 





Entry fornat depends on the entry type; the file systen uses entry type 0. 
The following partial word field identifiers are used: 


RF TTYPE = RFT.(0:4)8, entry type 
RFTNULL ew AFT. (4:1)0, GNULL file 
Discussion: 
RF TIOGX This ie the I0Q index of the pending nowait I/0 (if any). 


This is applicable if the file was opened with the NOQUAIT 
epticn specified. Also, CS and DS have the sane capability 
and use this cell in a consistent manner. This 18 because 
the IOUAIT intrinsic services the file systen as well as CS 
and DS, and is the principal user of this cell. If the I00X 
is negative, then one of tuo possibilities exist. If the 
file ie a message file, then file ICQx is the accessor's 
reply port. If the file is a standard NPE file, then a read 
was done to a nonexistent extent and this is simply a stud 
inserted by the file systen. 


RFTLACEOST This is the DST that the Logical ACB (LACS) if it existe. 
This is applicable if the file was cpened with the 
nulticaccess option specified. 


AFTLACBENTRY This is the word offset into the control block table of the 
LACB vector table entry, applicable if the file uas opened 
with the multi-accese option specified. 


RFTNULL This bit signifies that the file is SNULL and that there are 
ne control biccks. 
RF TPACEDST This is the OST that contains the Physical ACB (PACB). A 


PACB exists for all files except SNULL. 
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File Systen 


AF TPRCBENTRY This is the uord offset into the control block table of the 
PACB vector table entry. This wall be nonzero for all files 
except SNULL. 

AF TTYPE This is the AFT entry type nunber. At present the following 


entry types are defined: 


0 ~ File systen 

1 - Renote file 

2 - 0S (nowait 1/0 disallowed) 

3.- OS (nowait 1/0 alleued) 
cs 


4- 
§ - CS (Autedial) 
6 - KSAA 
8 - Message File 
9 - RFA Port 
13 - Advanced Netuork Subsysten 


Renote File AFT En 


45 6 7 8 910 11 12 13 14 15 


| FSTYPE UNUSED ail 
! REMOTE FILE NUMBER t 
! LINE NUMBER \2 
PENDING FCLOSE DISPOSITION FRON FOPEN 3 
| UNUSED : 
| TOQX \5 
| SS SGC SFE CSS C 09S4E 69S SEES 2EHE OE 84 SSE O44 SESSSABOSES | 
FT 0 
FSTYPE - This value will te 1 for renote files. 
AR - Set if the file uas opened nulti-access. 
AFT 1 - Local line nunber of renote file. 
ot 2 - File nunber of the renote file. 
3 o 


tales Rsaert ea of the file. Set when file was FOPEN'd 


and will possibly be used as the FCLOSE disposition. 


AFT § - No wait 1/0 Queue Index. 


eee ee | ee 
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File Systen 
KSAN_AFT_ Entry 
345 6 7 8 9 10 11 12 13 14 18 
eg ed ees be bs bs Cd Oo Cd DD od 
| FSTYPE | 
| AFT NUNBER OF KEY FILE I" 
| AFT NUMBER OF ORTA FILE : 
| KSAM XOS DST (Tagged “KSRA) \3 
| KSAN XDS DST (If<>0, tagged “RLXSAH*) \4 
i 10QX 15 
oo wecnncennne- - | 
RFT 0.(0:4) - FSTYPE (6) 
AFT 4 - RFT nunber of key file 
AFT 2 ~ AFT number of data file 
RFT 3 - KSAM XDS DST (Tagged “KSAN™) 
RFT 4 - KSAM KOS OST (If non-zero, the tag will be "RLKSAN") 
AFT 5 - No wait 1/0 Queue Index 
6.23.00 
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DS _RFT Entry 


0123485 6 7 8 91011 12 13 14 15 
Jon |n-[--f--1--fe- feed -= lod ee lee l-- lee 1-- teed -- 
| FSTYPE | CI M{ P| R{ OS ERROR NUABER 6 


 holaatatateletenetanaeate + [econ ew enccewecoccoroonesoooe= | 
| DSOCB INDEX | UNUSED . 
| eeceennew enn nnnna | oon e nnn nen eneonnennennences 
LOEV NUMBER ? 
| PREVIOUS RFT POINTER : 
| -nnnneen nn nnn nnn nn nnn n nn nn enn enn nen nn neneneen== 
| 100x 15 
|---onnnnmnnnnennnnnnonncncnennsconenneneennnne | 
0 
FSTYPE - This field will have the value 2 or 3. 
C - On if OSCPEN called by CXDSLINE or REMOTE’ HELLO. 
A - On if Master PTOP AFT. 
P - On if PTOP related. 
R - Qn if renote main process. 
RFT 1 - DS data segnent table pointer. 
AFT 2 - OSDSCB Index - OS data segrent control block index. 
RFT 3 Logical device nunber. 
AFT 4 - Preceding OS cpen RFT Pointer. 
AFT 5 - IOQX - Sane as described above. 
6.23.00 
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File Systen 
AFT for RFA 
| 3 45 6 7 8 9 0% 1 12 13 14 15 
bee red ed beer rd od bee bcd Dd Der ed Doe ed Doe oo 
0] FTYPE } SUBSYS | SUBYYPE | [NF 
" RFARASTER @ | UFCEW for RFA 
! 2| OSTX FOR RFA XDS BUFFER — 
| TPC ID, N/W RFA REMOTE ENVNUR ! 
| “ PENDING FCLOSE DISPOSITION CODE 
5{ OQ (NOWAIT 1/0) 
RFT 0 


FIYPE - This field will be 9. Data Conn FTYPE. 
SUBSYS - This field will be 2. ADS application services. 
SUBTYPE - 1 = Remote File Access. 

4 2 Renote Data Base Access. 


| - 0 = File is regular waited. 
1 2 File 1/0 is nowait. 
F - 0 = An error/failure cccurred. 


1 2 No error. MKornal cperaticen. 


11 
RFA’RASTER @ - Buffer nunber of RFA Master Entry. 


LFCB & - Buffer nunber of Local File Control Bleck Entry. 
RFT 2 - OST nunber of RFA XDS. 
AFT 3 
Ipc ID - IPC 10 for RFA nowait 1/0. 
ENVNUA - Environment nunber of renote environnent. 
AFT 4 ~ Pending FCLOSE disposition code. 
AFT § - I0GK - If <> 0, then it 19 the systen DB address of a 


single request I10Q entry. IQUAIT uses this word to 
pass the 100 index of the conpleted request for this 
AFT to CSIOUAIT. 
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123 4 5 6 7 8 9 10 11 12 13 14 1§ 


| FTYPE | Ul] WITO} BI UNUSED jo 
ea iwi hen AG 
|ow-~-vecrOR 10 MULITPLE 100 INDICES le 
re tate bia) sD 13 
| mT is 
1c ee 
AFT O 


FTYPE - This value will be 4 or §. A 5 signifies that the line 
has an autoedialer attached. 


u - The line has been cpened with no waiting on 1/0 requests. 
10 - Line is a multipoint control or 3270 station. 
8 - Line was opened with pee 
RFT 1 - Logical device nunber of the line. 
Al : - Vector to Multiple 100 indices. 
TR - Bit 0 on signifies tracing enabled. Bit 1 on signifies 
trace all. 
I - On if lane is currently connected. 


R - Signifies that this CS device is an SCCP device. 
DIAL - 0 # Dial on write, answer on read. 
1 s Ansuer cn urite, dial on read. 
2 # Aluays dial. 
3 = Never dial. 
RFT 4 - OST nunber of the line’s misc data segnent. 
RFT § - If «> 0, then it 18 the systen 08 address of a single request 
I0Q entry. JOURIT uses this word to pass the 100 index of the 
conpleted request for this AFT to CSIOGUAIT. 


6.23.00 
6- 13 


File Syeten 
Overhead 


it part labeled Overhead contains infornation pertaining to the entire 
t e. 


123 4 § 6 7 8 9§ 10 1% 12 13 14 15 


| 

| TABLE SIZE IN UORDS 10 C8TSIZE 

| | SST langen comaning TLE ty caostx 
| [ave] vecton IRae SIE Dn wos de 

| 2 aie imines | COTCONTROL 
| 1 Wi pearnn (eeovnan © pea'SuzE) ‘te cate 

| DP UINPEDED QUEUE BERD dS cenrauee) 
| |e ome 

! ses meet eal 


Other identifiers used: 


CBTTYPE = C&ETRB(2). (0:2) Control block table type 
CBTVTISIZE = CBTAB(2). (2:14) Vector table size 
CBTLOCKBIT = CBICONTROL. (1:1) Lock bit 


Discussicn: 


CBTOSTX This is the OST nunber of the data segnent that contains the 
control block table. If the table is contained in a stack, 
i.e., in the PXFILE area, then this is the OST nunter of the 
stack and not 0. 


CBTLOCKBIT If the entire control block table is locked, then thie bit 
1s stt. No leckang count is kept since control blocks are 
locked only once fron FCREATECB and FOELETECS uhen control 
blocks are aided to and deleted fron the table. The 
procedure LOCK’CB does not lock the control block because it 
runs PSEUDCDISABLED during the critical tines. 


CBTQUEUE This is the inpeded queue for the table and hae the sane 
fornat as the inpeded queue for a control block in the 
teble. There is no second inpeded queue because that 
facility 18 usea exclusively for BREAK requests against the 
PRCB for SS™NTh/SSTOLIST. 
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ont Block Tab BTRB 


a] 


A file control block table can be located in tuo places: as a subpart of the 
PXFILE area, or in a data segnent. Although putting control block tables in 
PXFILE has the advantage of providing rapid access, 1t detracts fron the 
space for the user’s stack; so the larger control blocks (or optionally, all 
control blocks) are put into extra data segnents. On the other hand, 
referencing extra data segnents nay result in an absence trap, which is slow. 


There are three types of extra data segnent control blocks; expandable, 
nonexpandable, and shared FCB. WNonexpandable CBTs are used for a single PRCB 
with buffers, i.e., where the control dlock is large or where the control 
block can’t be local to a single process (for multi-access). Expandable (or 
NOBUF) CBT¥s are used for snail control blocks ,as LACBs, PRCBs with no 
buffers, and FCBs which are local to a single process. A list of the 
expandable CBTs associated with a process is kept in the overhead area of 
PXFILE. When a small control block is needed, these CTs are checked in 
order to see if cne of then has roon. Shared FCB C8Ts are sinilar to 
expandable CBTs except that they belong to the systen rather than to a single 
process; the systen keeps a list of OSTs which it has assigned for this 
purpose. 


The overall structure of a control block table is: 


| 
| 
VECTOR TROLE were 
| | 
| poneceeeewncecwereconen| 
| | 
| | 
| | 
| CONTROL SLOCK | (VARIABLE) 
| AREA | 
| | 
| | 
{ | 
| covewwenenececoeronccne | 
6.23.00 
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CBTPIN This is the PCEPTR of the process that has the control block 


locked (PCBPTR = PIN’NUN * PCB’ ENTRY’ SIZE). 


CBISIZE This is the size in words of the table. It is initialized 
when the table is created and changed when the table is 
expanded. At present a table is never contracted, even 
though this is possible. 


CBTTYPE This field is the type of the control block table. Possible 
values are: 


0 
1 


Stack [PXFILE} 
NOBUF (expandable) 


2 Systen shared FCB 
3 Buffered (Contains a single PRCB) 
CBIVTSIZE This is the size, in words, of the vector table area in the 


control block table. It does not reflect the nunber of 
entries used cr unused. 


NOTE: All PINS are kept as the word offset into the PCB table and as the 
ectual PIN nunter. 
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Vector Table 
The part labeled Vector Table contains infornation used to locate and lock or 
unlock control blocks in the control block table. 


The overall structure of the vector table is: 


ENTRY 0 (FIXED, 8 WORDS) 


: | 
. | 
. | 


| 
ENTRY N | (FIXED) 


here N = (CBIVTSIZE/8) - 1. 

An unused vector table entry will have zeros in all the words of the entry. 

A used vector table entry will have a nonzero value in the first word of the 
entry (the control block address is necessarily nonzero). 


The general structure of a vector table entry is: 


1234 5 6 7 8 91011 12 13 14 15 


| 
| | CONTROL BLOCK ADDRESS 10 VT" ROR 
| {uel com | ows [VF conrRaL 
ci een oe evrem | 
| [wd PRTORTY weno corte i ae 
| [am paronry Tar ecopte T javreatan, | a 
| [iow patnary weno ecapta CS vr'smveonend | 
| [aaa paroRaTy ta pce 6 ve sivenranl_y 
| Li ctaiamccnienst altos! 
| Pointers 
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Control Bleck Ares 


The part labeled CONTROL BLOCK AREA contains the control blocks used by the 
file syeten. 


To facilitate storage nanagenent, all control blocks have the sane overall 
structure: 


123 45 6 7 8 910 11 12 13 14 15 


| 
| 
bie {0 C8DESCRIP 
1 | ' 
I | | 
i | DATA | 
i | | 
; | | 
i ft in 
| | peccccewnnneen en ennnenen nnn nceccwennnnncnnennne | 
Where N © Size-t. 
Partial word field identifiers are: 
CBTYPE = (B8.(0:2)4, control block type nunder. 
COSIZE s CB.(2:14)a; control block size 
Discussicn: 
CBDESCRIP This is the firet word of a control block; the fornat is 
connen for all control blocks. 
C8SIZE This is the size (in words) of the control block. The size 
includes the descriptor word. 
CBTYPE This is the type nunber of the control block. There are 
four types of control blocks: 
0 - Garbage 
1 - FCB 
2 - PACB 
3 - LACB 
6.23.00 
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The following partial word identifiers are used: 


VT’LOCK'BIT = VT'CONTROL. (0:1) 
VT'BREAK'BIT = VT'CONTROL. (1:1) 
VT’ COUNT s VT'CONTROL. (2:6) 


|Dascussion: (Note: PIN = PCBPTR in the discussions | PCBPTR 
= PIN’NUN * PCB'ENTRY’SIZE ) 


VT’ ADR Control block address 18 the table relative address of the 
control block associated with the vector table entry. It is 
a uord displacenent fron the beginning of the control block 
table. 


VT’ BREAK’ BIT This bit signifies that we are in the niddle of break node. 
This is used for the PACS of SSTDIN/SSTOLIST fron a terminal 
session only. 


VT° LOCK’ BIT This bit is set whenever the control block is lecked. 


VT’ COUNT This is the count of the nunber cf tines that the control 
block has been locked by the process identified in VT’PIN. 
If it is zero, then the control block is not locked. 


VT’ PIN Contains the PCBPTR of the process which has exclusive 
access to the control blcck. Other processes attenpting to 
access the block will be impeded and queued. PCBPTR = 
(PCB’NUM * PCB’ ENTRY’ SIZE) 


VT’ QUEUE The high priority impeded queve is a double uord of PINs 
that are the head and tail of the inpeded queue of processes 
waiting for access to the control block. Processes are 
inpeded and uninpeded by the file systen using the nornal 
nechanisns available under MPE. 


VT SRVEDQUEUE The low priority impeded queue is a double uord of PINs and 
has the sane format as VI'QUEUE. The only tine this uord is 
used 18 when the control block is in BREAK node, which can 
only happen to an ACB corresponding to SSTOIN/SSTOLIST. 

It 18 used to save the current VI’QUEUE when the control 
block goes into BRERK node and to restore VT’QUEUE when the 
control block goes back into nen-BREAK node. 


NOTE: ALL PINS are stored as offeets within the PCB table and not as actual 
PIN nunbers. 
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hen a control bleck table is created the initial control bleck area is 

conpletely allocated to a single control block of type garbage. Uhen space 

is requested for a new control block the control block area is scanned (using 

a first fit algorithm) for a garbage control block that 18 as large as the 

size requested. The space for the new control block is taken fron this 

— control block and the space renaining becones the new garbage control 
och size. 


When space is returned it becones a new garbage control bleck. To reduce 
fragnentation the new garbage control block 18 conbined with either of the 
tuo neighboring control blocks if they are of type garbage. 


If space is requested and no garbage control block is large encugh to contain 
the new control block then the control block area and control block table are 
expanded by a sufficient anount. If expansion is not possible, sone other 
control block table nust be used. 


Access Control Block (RCB 


Virtually every file systen intrinsic constructs an ACB as its firet ection. 
When using the nulta-access cption, each accessor shares a single PRCB. 
However each accessor is pernitted to view the shared file in a slightly 
different nanner than the other accessors. For exanple, one accessor nay 
access the file in a read-only node while the other accessors nay access the 
file in a read-urite mode. To do this, each accessor must, curing his 
access, have a slightly different RC8. 


The PRCB holds information that is global to all accessors of the file. The 
LACB holds infornation that is local to each accessor of the file. At the 
beginning of a particular access, an ACB is constructed by calling LOC’ACE, 
whach copies infornation fron both the LACB and the PACB. At the end of the 
access, the ACB is released by calling UNLOCK’ACB; this updates the PRCB and 
LACB fron the ACB since sone of the fields nay have been modified due to the 
access. This schene nearly eliminates EXCHANGEDS’s to access the various 
data segnerts. 
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Al] LACBs have the sane structure: 
3 4 5 6 7? 8 9 10 11 12 13 14 15 


o| 3 | COMPLETE Lace SIZE 


[ | 
| i FILE NUMBER i" 
} 2 PILE WANE - 1ST CHRR. 

| 
i 3 FILE MANE - - 3R0 CHAR. 


i 
| ‘| FILE MANE - STH CHAR. 
1 5! FILE NANE - 71H CHAR. FILE WANE - 8TH CHAR. {5 


PDB REDS OC ONG OS OOSODS OOS SHOHSSSSSESEE | eoenwncccceneweewnennseccensose | 


| 6) FOPTIONS \6 
[eee ee 
Area \3 
unl eu se nus Series ne Pe ‘3 
rr iG ina acauadiag 
; ia] caaaae coor coe 
| sal leorlee {ur ist {ee {7c (re (ae tcarioe | €or T | EOF n | {v2 
ate p mG HET at  Tenntwn Stop ennaacrEeR [19 
Sse ee aig 
uo Mima Oo 


Partial uord field identifiers are: 


LACBSIZE s (ACB.(2:14)8, size in words 
LACBSTOPCHRR = LACB(2).(0:8)#, terninal stop character 
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Phys} a k 


The overall structure of the PACE is: 








| | 
| 
| BASIC PACE pore 
[owocnncces | 
| | 
| BUFFERING ! 
| (VARIRBLE ) 
| EXTENSION | 
| 





The buffering extension is optional; it is present if and only if the file is 
accessed uith buffering. There are, therefore, tuo possible fornats for an 


1. No buffers; the buffering extension is not present. 


2. PACB buffers; the buffering extensicn is present and the buffers 
are in the buffering extensicn. 


If multiple PACB buffers exist, there will be 3 gare extension for each, 
inmediately preceding the buffer. The basic PACS (or NOBUF PACB) is copied 
into the the ACB as words 0 through 263; an ACB “extension” is then 
enerated in words 264 ~ X67. The resulting ACS thus has the tobseaies 
omat: 
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File Systen 


Discussion: 

LACBAOPTIONS See ACBROPTIONS. 

LACBBSIZE See ACBBSIZE. 

LRCECTL See ACBCTL. 

LACBERROR See ACBERROR. 

LACBFNUA See ACBFNUA. 

LACBFOPTIONS See ACBFOPTICNS. 

LACBNODE See ACBRODE. 

LACBNRE1-8 See ACBNANE. 

LACBPRCB This is the DST and vector table entry for the 
Physical ACB (PACB) for the file. 

LACBRSIZE See ACBRSIZE. 

LACBSIZE This is the size, in words, of the LACB. All LACEs are 
eighteen (decinal) uords long. 

LACBSTATE See ACBLSTATE. 

LACBSTOPCHAR See RCBSTOPCHAR. 

LACBTLOG See ACBTLOG. 
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n k (ACB) and Physical Acce ny k (PR 


3.4 5 6 7 8 9 16 11 12 13 14 18 
o} 2 | COMPLETE ACB SIZE lo 








ees] 
1| FILE NUMBER 1 


99080828 OC 0 6 0889S 808208 C082 CEGOSO | COOSS 60928 S0O OSE SSSESE846 S82 E68004° | 


| 
2| FILE WANE - 1ST CHAR. | FILE NANE - 2ND CHAR. {2 


2S SOS OSES 02848402 CC4 2946 0842S OHSHSESE | COBBHSSSHOSSESE 2 PP OPS SSSSOSOBDSAS® | 


3| FILE NAME - SRD CHAR. | FILE NAME - 4TH CHAR. {3 


4| FILE NAME - STH CHAR. | FILE NAME - 6TH CHAR. {4 


1 
5| FILE NANE - 7TH CHAR. | FILE WANE - STH CHAR. }s 


80 89S OS COS SO S246 6 £486 SSOOSOSBSE | OO GOS COGS SOSSSS BESDSSESSEESASOCO | 





6] FOPTIONS i. 
?| AOPTIONS (7 
10] _RECORD SIZE IN BYTES is 
1| ~ BLOcK SIZE IN WORDS fh 
12| UNUSED. ire 
si CARRIAGE CONTROL CODE hep htieodaay ) My 
14) JE€OF{PG JUN [ST JFK [TC [78 [8B [CARjOB | ECF T |] EOF MN | 412 
isl C ITE {1c | Q \ TERMINAL STOP CHARACTER (13 
16] ERROR CODE oe 
" LAST I/O TRANSMISSION LOG i 
20| j16 

| RECORD TRANSFER COUNT 
21} 7 
22| \18 

| BLOCK TRANSFER COUNT | 
a 1 
4} 120 

j FILE POINTER 
25| ie 
26] |22 

| CURRENT VARIABLE BLOCK NUMBER j 
a”) 123 
x) | (24 

i HIGHEST BLOCK NUMBER STARTED | 
au 
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Acces tro 


File Systen 


ocks (ACB*s) (Cont. 


123 4 § 6 7 8 9 10 419 12 13 14 15 


File 


The above uords, 0-263, are physically lo 


Systen 


cated in the PACE of the file. 


Below, words 264-267, are used by file systen intrinsics, and are placed onto 
stack by the procedure LOC’ACB when locking the ACB. Therefore, the 


the 


buffering extension, present, 
ACB in the Control Block Table o the file. 


0 1 


will immediately follow word 263 of the actual 


9 10 11 12 13 14 15 


|--- | eael| eee eee | awe | eee | ove | aan | ooo] --- | aoe 1 oan | cen | eee | ean ] eon 


64| DST RELATIVE OFFSET 10 PRCB 


est OST RELATIVE OFFSET TO LACB 153 
66| DST RELATIVE OFFSET TO ACB IN THE STACK 158 
ld STACK RELATIVE OFFSET TO 08 58 


The following adentifiers are used when referring to an ACB: 


(ACBSIZE) * 
ACBFNUM s 
ACBNARE 2 
ACBNANE1 s 
ACBNANE2 s 
ACBFOPTIONS = 
ACBAOPTIONS = 
ACBRSIZE 2 
ACBBSIZE 3 
Spare s 
ACBCTL = 
ACBLSTATE s 
ACBEOF z 
ACBLPCTL s 
ACBPAGECTL = = 
ACBLINECTL = 
ACBSTREAN 2 
ACBFKEYS s 
ACEXMITCRLF == 
ACBTBLOCK 2 
ACBBINARYIO = 
ACBCARRIAGE = 
(ACBDEFBLOCK) = 
ACBREADCODE = 
ACBREADTYPE = 
ACBREADMODE = 
ACBHOOW s 
ACBMODE 2 
ACBCIROVERF LOW= 
ACBSETMODE s 
ACBTAPEERROR = 
ACBINHIBCRLF = 
ACBQUIESCE 2 








[26 
| FCS VECTOR | 
| 3 \27 
| 3] TOTAL NUMBER OF LACB’S 128 
|---|--- | owoewnennnmennncerconne| seoeeenennnenccenennane sae: 
| 35} {6K | DEVICE TYPE | LAST LOGICAL 1/0 STATUS 29 
{| 36] LOGICAL DEVICE NUNSER ; 1d 
| 37)PF (HITI CURRENT BUFFER! TAPE DISPLACE NO. BUFFERS [31 
| “| CURRENT RECORD WORD INDEX 132 
| au BUFFER SIZE 133 
| ‘2 VIRTUAL LOGICAL DEVICE NO. 34 
| 3) FMAVT INDEX 138 
| “4 NUMBER OF INPUT LACB’S 136 
| “| NAME TYPE ! FILE DISPOSITION |3?7 
| ‘i ACEESS OT Re GLOCKING FACTOR |38 
47, S$} nta R | 0 | {AE (RU [ABRINE | SEOFS | EOFS (39 
| 50] SPOOLED DEVICE TYPE | SPOOLED DEVICE RECORD SIZE \~ 
| 51] SPOOLED DEVICE FOPTIONS is 
| 52] SPOOLED DEVICE ADOPTIONS |42 
| 531 I0D OR ODD INDEX 143 
|} Sal 144 
| NO-WAIT DISC ADDRESS | 
| $8] iss 
| Sél UNUSED a6 
| 57| NO-WAIT LOGICAL DEVICE \97 
| @l |48 
| PIP2 USED BY FOEVICECONTROL | 
| 61] {4 
| 62 UNUSED {50 
1 63} UNUSED ist 
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ACBSTOPCKAR = ACBNODU.(8:8)#, terninal stop character 
ACBERROR = ACB(14)e, error code 
ACBTLOG = ACB(15)4, last 1/0 transnission log 
ACBFPTR sz ACBDBL(O8)", current record nunbder 
ACBBLK = ACBDBL(O9)#, current variable block 
ACBRIFRCT ws ACBDBL(10)#, logical record TFR count 
ACBSTFRCT = ACBOBL(11)«, block transfer count 
ACBHIBLK ws ACBDBL(12)#, highest block started 
ACBFCBY = ACBDBL(13)4, FCB Vector table entry 
ACBSHCNT = ACB(28)e, # of LACBs 
ACBSTATW = ACB(29)H, access class, status, etc. 
ACBBRERK s ACBSTATU.(1:1)#, break ($STDIN/LIST only) 
ACBOTYPE zs ACBSTATU.(2:6)8, device type 
AcBACCCL s ACBSTATU.(2:3)8, device access class 
ACBSUBCL zs ACBSTATW.(5:3)8, device sub-class 
ACBSTATUS = ACBSTATU.(8:8)8, last logical I/0 status 
ACBOSTATUS = ACESTATW.(8:5)¥, qualifying status pert 
ACBGSTATUS = ACBSTATU.(13:3)#, general status part 
ACBDADOR = ACB8(30)#, Ldev nunber of file 
ACBBUFX = ACE(3:)M, buffer data & nisc. flags 
ACBPRIV = ACBBUFX.(0:1)8, privileged access only 
ACBHIT =z RCBBUFKX.(1:1)8, buffer hit flag 
ACECURRBUF = ACBBIFX. (4:4), current buffer nor. 
ACBNUNBUFS = ACBBUFX.(12:4)#, nunber of buffers less 1 
ACBBUFUSED s RCB(3c)#, used block word count 
ACBBUFSIZE = ACB(33)a, buffer size (uords) 
ACBSPVDEV = RCB(34)e, spooled virtual device 
ACBFAAVTX = Ata(35)#, FARVT index 
ACBSHENTIN = ACE(36)4, nunber of input LACBs 
ACBONTD = ACB(37)a, type & disposition 
ACBONTYPE = ACBONTD.(0:8)#, mane type for dar. search 
ACeDISP z fACBONTO.(8:8)8, file disposition 
ACBAMLD = ACB(38)e, access nask & LDEV 
ACBACCESS = ACBANLD. (0:8)e, access nask 
ACSBLKFACT © ACBANLD.(8:8)#, Blocking factor of file 
AceGSTU s ACB(39)4, spool control flags 
RCBSPOOLEO = ACBGSTU.(0:1)¥, spooled device flag 
ACBSPOOLIO = ACBGSTW.(0:2)8, spooled IN/OUT 
ACBSPSO @ ACBCSTU.(2:2)8, squeeze flags 
ACESPSGZ = ACBCSTW.(2:1)#, file squeezed 
ACBSPRSQ =z ACBGSTU.(3:1)#, request to squeeze 
ACBSPDSQ = ACBGSTW.(4:1)#, squeeze just done 
ACBNOWRITEOF = ACBCSTU.(8:1)e, EOF sovanced? 
ACBNOURITNODE = ACBGSTU. (9:1), last 1/0: Otread, i=urite 
ACBRBORTREAD = ACBGSTW.(10:1)@,  abzrt bronen re-read? 
ACBNENEOF = ACBGSTU.(11:1)#, EOF advanced - tape file 
ACBSRVEEOFS = ACBGSTU.(12:2)#, for saving ACBEOFS 
ACBEOFS 2 ACBGSTW.(14:2)¥, EOF Flags - :E00/: 
ACBSPTYRC = ACB(40)4, spooled dev type/receize 
ACBSPTYPE = ACESPTYRC.(0:6)#, sposled dev type 
ACBSPREC = ACBSPTYRC.(6:10)@, spooled dev rec size 
ACBSPFOPT = ACB(41)4a, spooled dev FOPTIONS 
ACBSPAOPT = ACB(42)8, spocled dev AGFTICNS 
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ACBSPXDDX 2 
ACBNOWRITOA == 
Spare 8 
ACBNOWRITLDEV = 
ACEP1P2 2 

= 
2 


ACBP1 
ACBP2 


Discussion: 


ACBABORTRERD 


ACB. (2:14)#, size in words 
RCB(1)e, file nunber 
ACE(2)e, file nane 
ACBDBL(1)#, file nane - first half 
ACBOBL(2)4, file nane - second half 
ACB(6)M, FOPTIONS 
Aace(7)a, AOPTIONS 
ACB(8)4, record size (bytes) 
ACB(9)e, block size (words) 
ACB(10)#, Unused 
ACB( 11 )#, carriage control uord 
ACB(12)e, local state flags 
ACBLSTATE.(1:1)#, end of file sensed 
ACBLSTATE.(2:2)¥, page and line control 
ACBLSTATE.(2:1)#, page control 
ACBLSTATE.(3:1)#, lane control 
ACBLSTATE.(4:1)#, strean 1/0 
ACBLSTATE.(5:1)#, restore function keys 
ACBLSTATE.(6:1)#, transmit CR,LF to user 
ACBLSTATE.(7:1)4, disable block node 
ACBLSTATE.(8:1)#, 8-bit terninal transfers 
ACBLSTATE.(9:1)#, carriage control flag 
ACBLSTATE.(10:1)0, default blocking 
ACBLSTATE.(11:4)#, input EOF check 
ACBLSTATE.(11:2)#, input EOF type 
ACBLSTATE.(13:2)0; input EOF node 
ACB(13)e, node word 
ACBMODW.(0:8)#, mode setting 
AcenooW. (0:14, signifies CIR overflow 
ACBNOOW. (4:4)e, FSETNODE bits 
ACBMODW. (4:18, report recovered tape error 
ACBNODW. (5:1)@, inhibit ternianal CR/LF 
ACBMODW.(6:1)#, critical output verify 
6.23.00 
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ACB(43)8, 100/009 index 
ACBDBL(22)4, Nowait disc address 
ACB(46)4, Unused 
ACB(47)e, Nowait logical device 
ACBDSL(24)#, Used by FDEVICECONTROL 
AcB(48 4, ” re] £3] as 
ACB(49)e; - 8 " “ 


This flag is used to abort a broken terninal re-read. The 


flag is set via the ABORT paraneter to FUNBREAK. If the 
flag is set then the READ PENDING neseage will be aborted 


alon 


the 
ACBACCCL 


This is the access class part of the device type nunber. 


with the re-read. 
ERK...:ABORT, etc., satuation. 


This feature is needed to handle 


The following are legal values: 


ACBACCESS 


© - direct (e.9., disc) 

1 - serial input (e.g., card reader) 

2 - parallel input/output (e.g., terminal) 

3 - serial input/output (e.g., magnetic tape) 
4 - serial cutput (e.g5., line printer) 


This is the access bit map for the file. The following are 


the bit definitions of this eight-bit field: 


(0:1) - unused 
(1:1) - unused 
(2:1) - read 
(3:1) - append 
(4:1) - write 
(5:1) - lock 


6:1) = execute 


731) - save 


Thie access security is deternined by the ACCCHECK intrinsic 
and enforced by the file systen. 


RCBAOPTIONS 
ACBBINARYIO 


node terninal. 


FCONTROL(27). 


This ie the ROPTIONS in effect for this file access. 


This bit controls full eight bit transfers on the 2644 page 
It is adjusted by FCONTROL(26) and 
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ACBBLK 


ACBBLKFRCT 


ACBBRERK 


RCBBSIZE 
ACBBTFRCT 


ACBBUFUSED 


ACBCARRIAGE 


ACBCTL 


ACBCURRBUF 


RCBDROOR 


RCBDEFBLOCK 


RCBDISP 


RCBFKEYS 


RCBF NUT 


RCBFOPTIONS 
RCBFPTR 


RCSFARVTX 


RCBGSTATE 


RCBGSTATUS 


RCBHIBLK 


RCEHIT 


ACBINHIGCRUF 


RCBLINECTL 


File Systen 


This is the block nunber of the current variable record 
fornat block. Rpplicable if the record format is variable. 


This is the blocking factor for the file. It is the nunbder 
of records in a block. Legal values range fron 1 to 255. 


This is the break node ict It is applicable if the ACB is 
for SSTDIN or SSTOLIST. If set it means that the BREAK key 
has been hit and that the CI should have high priority 
access to the ACB. The flag will be cleared when a RESUME 
or ABORT is issued. 


This is the block size, in words, of the file. 


This is the total nunber of blocks transferred to and fron 
the file. The initial value is 0D. 


This is the word index, relative to the base of the block, 
for the selected record within the block. This is 
applicable if the file access is buffered. 


This bit signifies that the file has carriage control. It 
is the sane as the carriage control bit in ACBFOPTIONS if 
the file is spooled. If not spooled, the bit is zero, and 
IONOVE will pass the FURITE carriage control paraneter 
directly to the driver rather than enbedding it as the first 
character of the cutput record. 


This is the CONTROL paraneter fron the last FURITE. This 
value re pertinent if the file was opened with carriage 
control. 


This is the buffer nunber (O-relative) containing the nost 
recently referenced record. Applicable if the file access 
is buffered. 


This is the logical device nunber of the file. For a disc 
file this is the logical device nunber of the first extent. 


This bit signifies that the file is to be accessed with 
default blocking. The bit ie initialized fron the FOPEN 
state word STATE. It does not need to be in the ACB; it is 
mentioned here only to signify that the bit is effectively 
used due to the way ACBLSTATE is initialized fren STATE. 


This is the file close disposition derived fron the FOPEN 
call. The only way this can be specified is via a file 
hl ake The legal values are the sane as those for 
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This bit controls the definition of the f1 and f2 function 
keys on the 2644 page node terninal; it is adjusted by 
FCONTROL(32) and FCONTROL(33). (Obsolete function) 


File nunber, range fron 1 to 255. Used nostly for calling 
routines that access things such as labels by file nunber. 


This is the FOPTIONS in effect for this file access. 


This is the sequential access record pointer; it contains 
the next sequential record nunter. The initial value is 0D. 
This value is used only by the FREAD, FURITE, and FUPDATE 
intrinsics. However, the value is maintained by all date 
transferring file systen intrinsics. 


This is the ant index into the file nulti-access vector 
table (FARVT). This is valid if the file access ie 
eulti-access. 


These are niscellanecus state flags. These are “global” in 
nature in that they are the sane for all accessors in a 
nulti-access environnent. The constituent bits are 
described individually. 


This is the general part of the last 1/0 status for the 
file. The following are the legal values: 


0 - pending 

1 - successful 

2 - end of file 

3 - unusual condition 
4 - irrecoverable error 


This is the highest block nunber for uhich an anticipatory 
read has been issued, and is applicable if the file sccess 
is buffered. The initial value is -10. 


This is the buffer hit flag. If set it indicates that the 
last read or write request uas serviced without any physical 
I/O required. This flag is used only for performance 
neasurenent. The code which nenipulates it is cptional to 
the file systen, and is controlled by conpiler tcggle X93. 


This bit controle the termination of lines written to the 
terminal. If not set then each line is terninated with a CR 
and LF; if set then no line termination characters are used. 
This bit is valid if the fale is a terminal file; :t is 
adjusted by FSETNODE. 


This is the line control bit. If not set then each line is 
post-spaced; if set then each line 18 pre-spaced. This bit 
is used by line printers and terrivals oniy. It is adjusted 
by FCONTROL(1) and FURITE wath the aopropriate carriage 
control. 


File Systen 


ACBONTYPE 


ACBDTYPE 


RCBECF 
RCBEOFS 


ACBERROR 


RCBFCB 


File Systen 


ACBLPCTL 


RCBLSTATE 


ACBNODE 


RCBNANE 


RCBNEWEOF 


ACBNOUATTEOF 


RCBNOUATTRODE 


RCBRUMBUFS 


RCBPRGECTL 


ACBPRIV 


RCBOSTATUS 


ACBQUIESCE 


This is the file reference fornat type nunber and is derived 
fron the FOPEN call. The following are legal values: 


0 - full nane 

1 - account nane absent 

2 - group and account name absent 
3 - null nane 


This information is needed by FREXANE. 


This is the device type nunber of the file. The following 
are legal values (octal): 


0 - noving head disc 
1 - fixed head disc 
3 - CS& device 
7 - foreign disc 
10 - card reader 


11 - paper tape reader 

20 - terninal 

24 - card reader/interpreter/punch 
26 - SSLC 

27 - progrannable controller 
3% - magnetic tape 

31 - serial disc 

4 - line printer 

41 - card punch 

42 - paper tape punch 

43 - CALCOMP S00 plotter 

44 - CALCONP 600 plotter 

45 - CALCONP 700 plotter 


Thies bit is set when EGF hae been sensed. 


This is the type of EOF detected on SSTDIN(X). This field 
consists of tuo bits: 


(0:1) = super colon (i.e., EOF for SSTDINX) 
(1:1) - regular colon (i.e., EOF for SSTDIN) 


Applicable for nulti-access to SSTDIN(X) only. 


This is the error nunber for the file. It is used by all 
intrinsice except FOPEN. When an error is detected the 
error nunber 19 placed in this cell. The error nunter is 
cleared at the beginning of each callable intrinsic except 
FCHECK (which reads it). 


This is the FCB vector for the file. Applicable only to 
disc files. 
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This are the line and page control bits, which are described 
separately. 


These are niscellanecus state flegs. They are “local” in 
nature in that they nay be different for each accessor in a 
nulti-access environment. Bits (9:6) are initialized fren 
the state word lecal variable called STATE in FOPEN; the ten 
renaining bits are initialized individually. The 
constituent bits are described individually. 


These are niscellanecus node flags. The constituent bits 
are described individually. 


Thie is the local file nane. The nane is eight bytes in 
length with trailing blanks added. 


This flag uhen set indicates that a neu tape mark should be 
written before the tape is rewcund or backspaced. 
Applicable only to nagnetic tape files. 


This bit is used to save the value of the local EGF advanced 
flag NEWECF in IONOVE betueen the 1/0 initiation and 1/0 
conpletion calls. This flag is applicable if the file is 
accessed in nowait I/0 node. 


This cell is used to save the 1/0 node betueen nowasit 1/0 
initiation and conpletion calle. If the bit is set then the 
last 1/0 request was a write; otheruise it ues a read. This 
_ is pertinent if the file is accessed in nouait 1/0 

e. 


this is the nunber of buffers, less one, used for the file 
access. Applicable if the file access is buffered. 


Thies ie the page control bit. If not set then a page is 
assured to consist of 60 lines (auto page eject); if set 
then a page is assuned te consist of 66 lines (no auto page 
eject). This ie used prinarily for line printers but is 
also valid for terninals; these are the only devices for 
uhich this is valid. This bit is adjusted by FCONTROL(1) 
and FURITE with the appropriate carriage centrol. 


This flag when eet indicates that the file is privileged in 
that it has a negative file code; the user nust be in 
privileged node to accees it. 


This ie the qualifying part of the last I/0 status for the 
file. The values are unique for each general status part. 
See 1/0 Systen INS for all legal values. 


This bit controle critical cutput verification. If set, 
buffered output is guaranteed to have been written to the 
device when control is returned to the user. This bit is 
adjusted by FSETHODE. 
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ACBREADCODE 


RCBREADACDE 


RCBREADTYPE 


ACBRSIZE 
ACBRTFRCT 


ACBSRVEEOFS 


ACBSHCNT 


ACBSHCNTIN 


ACBSHCNTS 


ACBSTIZE 


ACBSPAOPT 


ACBSPFOPT 


ACBSPOOLED 


ACBSPOOLIO 


ACBSUBCL 


ACBTAPEERROR 


ACBTBLOCK 


ACBTLOG 


RCBVORODR 


RCBXAITCRLF 


File Systen 


This field consiste of the input EOF checking type and node, 
and is used to generate the P1 paraneter to ATTACHIO. These 
fields are described andividually. 


This field controls the input EOF checking mode. It is 00 
for reading SSTDIN, 01 for reading SSTDINX, and 10 for the 
Connand Interpreter. 


This field controls the input EOF checking type. It is 01 


for JOBs, 10 for SESSIONs, and 00 for DATA. 
This is the file’s record size in positive bytes. 


This is the total nunber of records transferred to and fron 
the file. The initial value is 0D. 


This field is used to save the contents of ACBEGFS during 
BRERK node processing. 


This is the total number of LACBs that exist for this PRCB. 
Valid if the file access is nulti-access. 


This is the total nunber of input-only LACBs that exist for 
this PRCB. Valid if the file access is nulti-access. 


This is the total LRCB and total input-cnly LACB counts, 
each of uhich 18 described separately. 


This is the size, in words, of the ACB. The conplete size 
(including buffers) may be calculated fron the OST size 
containing the ACB. It does not include the buffering 
extension, if present. 


This is the AOPTIONS for the spocled device. 
if the file access 19 to a spooled device. 


Applicable 


This 1s the FOPTIONS for the spooled device. 
the file access is to a spooled device. 


Rpplicable if 


This is the spooled device flag. If set then the file 


access is to a spooled device. 


This field is a conbination of the spooled device flag and 
the input/output node of the spooled device. (egal values 
are: 


00 - not spooled 

O01 - illegal 

10 = input spooling 
11 = output spooling 
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This is the sub-class part of the device type nunber. The 
sub-class is unique for each access class. The following 
are the legal sub-class values for each device class: 


0 - direct 
0 - noving head disc 
1 - fixed head disc 
7 - foreign disc 
1 - serial input 
0 - card reader 
1 - paper tape reader 
2 - parallel input/output 
0 - terninal 
4 - card reader/punch 
6 - SSLE 
7 - progrannable controller 
3 - serial input/output 
QO - magnetic tape 
7 - serial disc 
4 - serial output 
0 - line printer 
1 - card punch 
2 - paper tape punch 
3 - CRLCOMP SOO plotter 
4 ~ CALCONP 600 plotter 
5 - CALCONP 700 plotter 


This bit controls the reporting of recovered nagnetic 
errors. Jf not set the recovered errors are not reported to 
the wser; if set then recovered errors are reported to the 
user by returning CCL and error nunber 39. Valid if the 
file iy magnetic tape file. This bit is sdjusted by 
FSETNODE. 


This bit controls block nede transfers on the 2644 page node 
terminal. Thies bit is adjusted by FCONTROL(28) end 
FCONTROL(29). 


This is the last 1/0 transniession log for the file. It 
cones fron the I/0 transnission log part of the I0CB 
returned by ATTACHIO. Not all ATTACHIO calls update this 
cell. 


This is the volune table index for the file. 
the file is a disc file. 


Applicable if 


This bit controls CR and LF insertion into the user buffer 
on the Hr 2644 on Node Terninal. This bit 18 adjusted by 
FCONTROL(30) and FCONTROL(31). 


File 


Systen 


ACBSPREC 


ACBSPTYPE 


ACBSPTYRC 


ACBSPVDEV 


ACBSPXOOX 


ACBSTATUS 


ACBSTOPCHAR 


ACBSTRERM 


File 


Systen 


This is the record size, in bytes, of the spooled device. 
Applicable if the file access is to a spooled device. 


This is the device type (fron the UDT) of the spooled 
device. Applicable if the file access is to a spooled 
device. 


This cell contains the spooled device type and record size, 
which are described separately. 


This is the logical device nunber of the spooled device. 
Applicable if the file access is to a spooled device. 


This is the index into the I0D or 000 for a spcolfile. 
Applicable if the file access 1s to either a spooled device 
or a spoolfile. 


This is the last I/0 status for the file. It cones fron the 
1/0 status part of the IOCB returned by ATTACHIO. Not all 
ATTACHIO calls update this cell. 


This is the record ternination character used for terminal 
reads. This character can be changed via FCONTROL(25). 


This bit signifies inter-block garbage for disc files. If 
set, the block size 18 a multiple of 128 words and 
therefore, there is no garbage data betueen blocks. This 
fact 18 used to inprove nultirecord I/0 by mapping the 
request into as few ATTACHIOs as possible. 
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If present, the PACB buffering extension contains fron one to sixteen block 
buffers each having the following fornat: 


1 





6 7 8 9 10 11 12 13 14 15 


) I0Q ENTRY INDEX eae BLKIOQX 
| 1 BLK LDEV NUNBER | : . i" in IP : BLKF LAGU 
} 2 I0C8 - STATUS | BLKLSTAT 
| a IOCB - TRANSMISSION LOG k BLKTLOG 
| 4] 14 BLKBLOCK 
| BLOCK NUNBER | 
| . lg 
1 61 [6 BLKDADOR 
| BLOCK SECTOR RODRESS | 
| y ? 
| 10] }8 BLKEXTBASE 
| BLOCK EXTENT BASE | 
} 11 is 
| 12] BLOCK EXTENT SIZE 110 BLKEXTSIZE 
{ 13] UNUSED i 
| 14 {12 BLXBUFFER 


| 
| 
BUFFER 
| 
1 
| 


S20 8902 O0S8 2SO80E 8 FS OSES SL ee 22OSE44O8 SSS CEBBOTHSOTBSO | 


Other identifiers used: 


BLKF LAGU = BLk(1>#, flay and LOEV word 
BLKLDEV = BLKFLAGW.(0:8)4, block Jogiceas device nunber 
BLKF LAGS = BLKFLAGW.(0:834, block 1/0 flags 
BLXUNALLOCEXT = BLKFLAGU.(10:1), ktlock fron unalioe. extent 
BLKREVERSE & BLXFLAGW.(11:1), FREPDBRCKURPD (not usez) 
BLXDONTWAIT = BLKFLAGW.(12:1), I/0 status scot checked 
BLKIOCUT = BLKFLAGU. (13:1), last 1/0 was rite? 
BLKDIRTY = BLKFLAGU. (14:1), buffer nodified? 
BLKIGPEND = BLXFLAGU. (15:1), 1/0 in pruscess: 
BLKIOCONP = BLKFLAGU.(14:2)#, 1/0 conplete - not dirty 
BLXTOCB = BLKOEL(1)#, p cere | 
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Discussion: BLKLDEV This 18 the logical device nunber of the block. (Valid cnly 
for dise files.) 
BLKBLOCK This is the block nunber of the data contained in the 
buffer. fA value of -1D indicates that the buffer is enpty. BLXLSTAT The 1/0 status part of the I0C8 consists of the PCB nunber 
and the error code for the conpleted I/0 request. 
BLKSUFFER This is the actual file systen buffer space. Each buffer is —— 
exactly one fale block in size. BLXTLOG The transnission log part of the I0CB is the nunber of 
uords or bytes transferred by the 1/0 request. 
BLKORDOR This is the block’s logical device and sector nunber. 
BLKREVERSE This bit would indicate that we are reading back- wards fron 
BLKDIRTY This flag 1s set if the contents of the buffer has been a tape. However, currently FRERDBRCK- WARDS can only be 
nodified. hen the block buffer is re-used this flag is perforned unbuffered. 
checked to see if the block needs to be written to the 
device. BLKUNALLOCEXT This bit signifies that the block was “read” fron an 
unallocated extent. Actually, the buffer uas sinply cleared 
BLKDONTUAIT This bit will be on if the I/0 was already conpleted via with fill characters. Therefore, if a urate 1s attenpted to 
"DONT'WAIT” but the status has not been checked yet. Check the bleck residing in this buffer, it must pass through 
the status before using the block in the buffer. FCONVBLK to allocate the extent first. 
BLKEXTBASE This is the sector address of the extent base in uhich the 
block resides. This is used for dise caching. 
BLKEXTSIZE The size, in sectors, of the extent in uhich the block 
resides. This is used for disc caching. 
BLKF LAGS These are the miscellaneous flags associated with the block, 
which are described separately. 
BLKICCS This is the I0C8 returned by the 1/0 systen when the block 
I/O has conpleted. On a blocked 1/0 request this is 
obtained fron the ATTRCHIO call; on an unblocked 1/0 request 
this is cbtained fron UAITFORIO. 
BLKIOCONP This is the buffer modified Flag (BLKDIRTY) and the 1/0 in 
progress flag (BLKIGPEND), which are described separately. 
This field 18 usually interrogated to see if it contains the 
value 2, which means that the buffer has been modified but 
not yet uritten to the device. 
BLKICOUT This is the node of the I/0 operation for the block. It is 
set by a urite and cleared by a read. 
BLKIOPEND This is the 1/0 in pregress flag. It is set if the 1/0 is 
pending; it is cleared when the I/0 has completed. 
BLKICOX This is the I0Q index of the unblocked 1/0 request for the 
block. It 1s used as the argunent to URITFORIO, which 
ensures the conpletion of the 1/0 request. 
6.23.00 6.23.00 
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File Con k(F File Control Block (Cont.) 
The FCB coordinates access to a file cn a sharable device. At present the | 345 6 7 8 9 10 11 12 13 14 15 
only sharable device is a disc, so only disc files have FCBs. | PP 
The infornation contained in an FCO is derived fron the file label. The FCS wor renececcene --| 
is used to hold this information, rather than the file label, since it can be | 15] UNUSED 113 
accessed nore quickly. eecccceccoecccnnnccncocowowesesocssesenscocosoe 
{ 16] 114 FCBEOF 
There are tuo strategies to choose fron in deciding where to place the FCB. | END OF CATA POINTER 
If the file has been opened exclusive and no other process could possible ! 17 115 
share this file, then the FCB is placed into the PXFILE area (or in a NOSUF seweeenewonwecencereons | ono coceewncnwenecceee=| 
expandable CBT if it won’t Fit in the PXFILE area or if the progran is run | 2O/NO. USER LABELS WRITTEN] |NO. USER LABELS AVAIL. 16 FCBUSERLBL 
with NOCB). If the file could possible be shared, then the FCB is aluays | wecsecececcccsncen wocne | wccccor con cocennoocone= 
placed in a shared contro] block table. The nunber of a data segnent { 2 EXTENT SIZE IN SECTORS J17 FCBEXTSIZE 
containing a list of shared file systen data segnents is kept in systen moweccccccowoccoccooens | pencccoccescseecococon= 
global location 1076 octal. The size of the FC8 depends cn the naxinun | 22] BLOCKING FACTOR | SECTORS PER BLOCK [18 
nunber of extents specified at FOPEN; there are 44 (octal) words plus tuo per | wwcceconeocee swewwecese | corcena- | coowooreonneee 
extent. There will be at least one extent, since the file label aluays | 23] SECTOR OFFSET TO DATA | DISP (NO. EXTENTS-1 [19 
exists in the first extent. The FCB extent nap is in terns of logical device | seewwencoccccoccscccccs | cocececs | coowoonen ween 
and sector nunber. The extent nap in the file label is in terns of volune 24 LAST EXTENT SIZE IN SECTORS {20 FCBLAST- 
rather than logical device; the nap is converted by VIABTOLDEV when the label | eoecowcceccnnocnncene weccerncceoee| = EXTSIZE 
is read, and converted back by LDEVTOVTRE uhen the label is uritten to disc. | 25] 0. OPENS INPUT NODE j2t 
The File Control Block has the follcwing fornat: |  26|GROUP KANE - 1ST CHRR. 1CROUP WARE - 2ND CHAR. |22 FCBGM 
| 27)6RO0UP © 3RD CHAR. |GROUP WANE - 4TH CHAR. (23 
| 01234 5 6 7 8 9 10 11 12 13 14 15 ceowewoonoocorccccococe | comeneesecncocccecoc coe 
| Fed Fated Uated Rated Gamed bated etd Rated Gated Gated ed Dated feted ted GC | JO|GROUP KANE - STH CHAR. |GROUP NAME - 6TH CHAR. (24 
; of 1 | COMPLETE FCB SIZE seovennescesecececcscce anmaacacccrane= - 
| | onan | nnn nn ne on cmc nw wn own enn ween enenocensonee= | | 31 |GROUP WANE - 7TH CHAR. (GROUP NAME - STH CHAR. (25 
i 1 RESERVED ‘ socrescereceoser sconces | ooweroeenecenccecencres 
ececwccnccccce wooceee eecewccncewneeweceesecsone } 32{ ACCT WANE - 1ST CHAR. | ACCT NAME - 2ND CHAR. 126 FCBRN 
| 2 FOPTIONS 12 FCBFOP- weccccocococscccsscescs | eooocccnccecencoce coos 
sewccercecscccce coccenneee wcorewccecccccsccesee| TIONS | 33] ACCT WARE - 3RD CHAR. | ACCT WANE - 4TH CHAR. (27 
| 3 OEVICE SPECIFICATION 3 FCBDEVICE snecerecensocoesoossecs | cowroncwconerccnosecsos 
| |ennee | noo cceene a ete en Oe ee | 34] ACCT KANE ~ STH CHAR. | ACCT NAME - GTH CHAR. (28 
[| 4fPR LK] DEVICE TYPE 1 Cl Vv | JOEV SUBTYPE|4 Seemnswnenesesocroreces | soo neeocenceswnncosoree 
| wae en | nna e- none n we nne | -~ | en ne- | += | ooo -- ee o en] | 35] ACCT MANE - 7TH CHAR. | ACCT NAME - 8TH CHAR. (29 
| 5S] NO. OPENS FOR OUTPUT [5 |onnennnne cocene | ennnnnnnnenseneeenconne 
| ecwwweeenne commen enn wenn eccennnm ec enensonscoce | | 3% 130 FCBSTART 
| 6 NO. OFFNS FOR ANY NODE is ' x} START CF FILE BLOCK KUNSER lst 
| 27 RIN NUMBER |? FCBRIN | cecccwereressenenswscsocscoonccoores 
Jeo enen woe nen ec econee meeweeccscccowesececenes ---| } 4| {32 FCBEND 
rel EXCLUSIVE STATUS is ecuenc- a] CURRENT NUMBER OF CATA BLOCKS IN THE FILE | 
wo Jooe-- - 0+ [ono one cone wee eweens connec cocesocoan 
, tect | mMVTRBX | VnASK 19 FCBPVINFO i comenesnns 
| | on | -- ee nn cn | eos nce wnwnn | enema en seree wenn ececona| |} 42] |34 FCBNUA- 
} 12] {10 FCBFLIN | MO. OF OPEN RAD CLOSE RECORDS (MESSAGE FILE) | OPENCLSREC 
| FILE LINit i )  43| [35 
} 13] {11 |----- aconeewwenwwewnnnen coocee| 
|--neewonannncenennnnnnneennnnnmennnnscnenennees | 
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File Control Block (Cont.) 


{36 FCBEXTHAP 


45] FIRST EXTENT SECTOR NUMBER 13? 
| eewennnnnnannanne wenn nenneneneeeneeeennenennne 
l | 
ee 
l _— | | 
| LOGICAL DEVICE NUMBER | | 
| eeeeccooscoecoscossccae 
| LAST EXTENT SECTOR NUMBER 
| 88S O60 SS8 49S SOSS SESS SESSSTESBDBOSTGE 2B @2eeGeenoeaa 


Other identifiers used: 


Discu 


FCBAC 


FCBRC 


FCBAN 


FCBSIZE 
FCBLKST 
FCBDTYPE 
FCBCRUNCH 
FCBVERSION 
FCBSUBTYPE 
FCBOCNTOUT 
FCBOCNT 
FCBCLASSFLG 
FCBMVTREX 
FCBVNASK 
FCBLBLECF 
FCBLBL 
FCBBLKFRCT 
FCBSECTPBLK 
FCBSECTOFF 
FCBOISP 
FCBNUNEXTS 
FCBOCNTIN 
FCBLABEL 
FCBLDEV 


sion: 


BDST 


BV 


FCBFOPTIONS 


FCEGN 


FCBLABEL 


FCBLA 


FCBLB 


FCBLB 


FCBLD 


FCBLK 


FCBMV 


FCONE 


STEXTSIZE 


L 


LEGF 


eV 


ST 


TREX 


uFCBDST 


FCBNEWFCEV 


FCB(O).(2:14)#, size in words 


FCB(4).(0:2)#,  previcus lock state 
FCB(4).(2:6)4, device type 

FCB(4).(8:1)#, pending crunch disposition 
FCB(4).(9:2)#, file version (V-Delta-3) 


FCB(4).(12:4)8, device subtype 


FCB(S5).(0:8)#, no. accessors - output 
FCB(S).(8:3)#, no. accessors 
FCB(9).(0:1)8, PV class flag 
FCB(9).(4:4)8, mounted volune table index 
FCB(9).(8:8)8,  volune nask 


FCB(16).(0:3), no. labels written 
FCB(16).(8:8)8, no. labels available 
FCB(18).(0:8)8, blocking factor 
FCB(18).(8:8)8, sectors per block 
FCB(19).(0:8)#, sector offset to data 
FCB(19).(8:3)%, pending disposition 
FC8(19).(11:5)#, no. extents less 1 
FCB(21).(8:8)#, mo. accessors - input 
FCBDBL(18)e, label LWEV and sector 
FCB(36).(0:8)#, label LOEV 


This is the DST of the ACB that was created at the sane tine 
as the FCB. This is used in conjunction with FCBNEWFCEDST 
uhen relocating the FCB. 


This is the vector table entry of the ACB that was created 
at the sane tine as the FC8. This is used in conjunction 
with PFCSNEWFCBV uhen relocating the FCB. 


This is the account nane of the file. It is eight bytes in 
length with trailing blanks added. 
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Thie is the FOPTIONS in effect for the file. 


This is the group nane of the file. It is eight bytes long 
with trailing blanks added. 


This is the logical device and sector nunbder of the file 
label, which is the sane as the first extent descriptor. 


This is the size, in sectors, of the last extent in the 
file. If the file has one extent then this is the sane as 
FCBEXTSIZE; otherwise this value nay be different fron 
FCBEXTSIZE. This is the size of the last physical extent 
for the file; it is not the size of the last allocated 
extent. 


This is the nunber of user labels allocated for the file. 
Since each label is a sector leng, this is aleo the nunber 
of sectors allocated for user labels. 


This is the end-of-data pointer for the user labels. It is 
analogous to FCSEOF in that it represents the nunber of 
labele uritten. The initial value is 0. 


This is the legical device nunber of the first extent of the 
file. 


This is the previous lock state of the file and is derived 
fron the file label. Legal values are: 


0 - no accessors 
1 - read 

2 - write 

3 - read/urite 


If the file resides on a private volune, then this field 
represents the nounted volune table index of the volune set 
entry on which the file resides. 


This is the OST of the new FCB for the file. It is used in 
conjunction with FCBACBDST to nove the FCB to a systen 
(shared FCB) control block table uhen the second accessor is 
established. If this value is zero then there is no new 
FCB; if nonzero then a new FCB has been created. 


This is the vector table entry of the new FCB for the file. 
It is used in conjunction with FCBACBV to move the FCB to a 
systen (shared FCB) control block table when the second 
accessor is established. If this value is zero then there 
is no new FCB; if nonzero then a new FCB hae been created. 


File Systen 


FCBBLKFACT 


FCBDEVICE 


SCBOISP 


FCBCRUNCH 


FCBDTYPE 


FCBEND 
FCBECF 


FCBEXCLSTAT 


FCBEXTRAP 


FCBEXTSIZE 


FCBFLIN 


File Systen 


FCBNUREXTS 


This is the blocking factor of the file. It is the nunber 
of logical records in a physical block. Legal values range 
fron 1 to 255. 


This specifies the device on which the file resides. If it 
is positive then it represents a logical device nunber; if 
negative it represents 2 (negative) device class index. 


This is the pending FCLOSE disposition for the file. Legal 
values are: 


0 - no change 

1 - save pernanent 

2 - save temporary and rewind 

3 - save tenporary but do not rewind 

4 - release 

7 - invalid file (file label access error) 


This bit governs if space will be returned beyond the EOF 
upon the last FCLOSE of the fale. 


0 - no change 
1 - return space beyond ECF 


This is the device type nunber of the first extent of the 
file. See ACBDTYPE for a list of legal values. 


Block nunber of the file’s EOF, relative to FCBSTRRT. 


This is the end-of-file pointer for the file. It is a 
double integer representing the nunber of records in the 
file. It can aleo be viewed as the record nunber of the 
next record past EOF. 


This is the exclusive status of the file access. If -1 then 
the file is being accessed exclusively; otherwise it is the 
nunber of seni-exclusive accessors. 


This is the extent nap of the file. The number of extents 
is specified by FCBNUMEXTS; a OD extent descriptor indicates 
that the extent has not been allocated. 


This is the extent size, in sectors, of the file. All 
extents in the file except possibly the last have this size. 
This is a logical value, and legal values range fron 1 to 
65535 sectors. This restricts the naxinun file size to 
2097120 sectors (268,431,360 words). 


This is the end-of-space pointer for the file. It is a 
double word integer representing the naxinun nunber of 
records (fixed length record fornat) or blocks (undefined or 
variable length record fornat) in the file. 
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This is the naxinun nunber of extents, less cne, allowed for 
the file. It is not the nunber of extents presently 
allocated, uhich is always deternined by counting nonzero 
entries in the extent nap. 


FCBNUNOPENCLSREC Nunber of open and close records in the nessage file. 


FCBOCNT 


FCA@OCKTIN 
FC8CChTOUT 
FCBRIN 


FCBSECTOFF 


FCBSECTPBLK 
FCBSIZE 


FCBSTART 


FCBSUBTYPE 
FCBUSERLBL 


FCBVERSION 


FCBVMASK 


This is the nunber of accessors for the file. Alternatively 
it can be viewed as the nunber of PRCBs created for the 
ale. 


This is the nunbder of file accessors having input access. 
This is the nunber of file accessors having cutput access. 


This is the RIN nunber used to support dynanic locking 
(i.e., FLOCK and FUNLOCK) for the file. If there is no 
dynanic locking then this nunber is zero. 


This is the sector offset fron the file label to the first 
block of the file. This is not necessarily equal to 
FCBLBL+1 since an integral nunber of blocks are allccated 
for the file and user labels. 


This is the nunber of sectors in a block for the file. 


This is the size, in uords, of the conplete FCB. It 
includes the extent nap. 


Block nunber of the file’s start, excluding the file label 
block. 


This is the device subtype nunber of the first extent. 


This field describes the user labels for the file. It 
consists of FCBLBL and FCOLBLEOF, described separately. 


Starting uith V-Delta-3 this field specifies the version of 
NPE a file was created on. Legal values: 


0 - a file created before V-Delta-3 
1 - a file created on V-Delta-3 or iater 
2,3 - currentiy undefined 


if the file resides on a private volune set, this bit nask 
s:gnifies uhich volune of the set in which the file resides. 
3it 15 is on if it resides on the first volune, bit 14 if on 
the second, and so forth. 
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File Label (FLAS) 
The file label has the following fornat: 


| 01234 5 & 7 8 § 10 11 12 13 14 1§ 


| o| FILE WANE-1ST CHAR. | FILE NANE-2ND CHAR. |O FLLOCNANE 
| a, enue wano cima | FILE WanE-aTH CHAR. 
| gt TFILE WanesSTN CHARS | FILE WAME-GTH CHAR. (2 
| oa Gitz’emecren cones | Prue wane-an chan, 3 
| al Gaoup wanecist cum. | GROUP RARE-2ND CHAR. /4 FLGRPWRNE 
| gt GROUP NARECARD CHAR. | GROUP MARECATH CHAR.” {5 
| 6 cach = STH CHAR. | GROUP AAREMGTH CHR [6 
\7 


8 FLACCTNANE 


S 


$ 
a 
e 
e 
e 
8 
Q 
9 
e 
4 
6 
] 
é 
e 
H 
; 
8 
4 
a 
r) 
6 


EY 
a 
ec 
“oo 
= 
= 
= 
oe 
—_ 
= 
mn) 
= 
z= 
= 


| oe 
} 10] ACCT NANE-1ST CHAR. 


2 OOOS C2804 OSE 8 C88 82ESO0 G | 9 8S82 88282 2O8 COST UTBSHO88 


| 11] ACCT NAME-3RD CHAR. ACCT RN CHAR. {9 


| 
| | 

1 12) ACCT NANE-STH CHAR. ACCT wAnE-6TH CHAR. [10 
| 


a J 
~~ 
= 
zz 
= 
~™ 
8 
— 
= 
oo 
oO 
= 
2 
rad 


acececcanncccccccccecce | ooeceecnnewosecoceese- | 
} 13] ACCT WANE-7TH CHAR. AcCT NANE-8TH CHAR. 11 
| 14 | CREATOR NANE-1ST CHAR. | CREATOR NAME-2ND CHAR. 12 FLUSERTIO 


| 15] CREATOR NANE-3RD CHAR.| CREATOR NANE-4TH CHAR. |13 


| 16] CREATOR WANE-STH CHAR. | CREATOR NANE-6TH CR: \14 


} 17] CREATOR WANE-7TH CHAR. | CREATOR NANE-8TH CHAR. }15 


S88 S8 COS S8 0OES OSSOSSSKES | 08 SESSS9S CESSES CEOOHESO 


| 20] LOCKNORD-1S7 CHAR. } LOCKUORD-2ND CHAR. 116 FLLOCKWORD 


| 2%] LOCKWORD-3RD CHAR, | LOCKWORD~4TH CHAR, {17 


| 22] LOCKWORO-STH CHAR. | LOCKUORO-6TH CHAR. {18 


| 23] LOCKWORD-7TH CHAR. | LOCKWORO-8TH CHAR. [19 


289828888 E OSS SS888OSC HOSS | COS OSS 2SE2008 SOS2e 000 


1 24] |20 FLSECHX 
os SECURITY MATRIX } 


26| FILE LANGUAGE ATTRIB. | |SR| $122 
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File Label (Cont) 


0123 4 5 6 7 8 9 10 11 12 13 14 15 


| 
VOLUME TABLE INDEX | 





SED CUED EE ES ED OD GP CU a 


LAST EXTENT SECTOR NUMBER 


DB OGPDSODOSS 8 O82222 6822288: 








PPD ODP SE ew 
. 


}154 FLALLOCTINE 














FILE ALLOCATION TINE | 
| 109] 1155 
| 156] FILE ALLOCATION DATE 1110 FLALLOCDATE 
| as UNUSED 4911 
{| 160] {112 FLSTART 
| START OF FILE BLOCK NUNSER | 
| 161] 1113 
| 162| 114 FLEND 
| GLOCK NUNBER OF END OF FILE 
| as me 
| 164] 1116 FLNUNOGPENCLSREC 
| NUMBER OF OPEN AND CLOSE RECORDS | 
1 165] (NESSAGE FILE) 1117 
| 166] 118 
| LAST FILE MODIFICATION TINE FLAODTINE 
{ 167] 4119 
| 170] Volune Table Index | Pext (HODA) 1120 FLPEXT’ ADDR 
| 171] Pseudo Extent sector nunber (LODA) 121 


OO OO OO OO 6 06 80 S808 9088G6 | 208 SE8SEE48 SEO SSSSE8OOO8S8 } 


| 172{File label exten. size [Security extension size|122 FLPEXT’ SIZE 


2980208 SS88SO828828808H68860 | SOS 28SSSSO24 BESOSO8 2H80 


173} UNUSED J123 


} 
| 174] DEVICE NANE-1ST CHAR. | DEVICE WAME-2ND CHAR. (124 FLDEVNANE 
l 


22000080806 892OS00 0 0S G8 | BHS2SE SESS SS SOSSS2T OSTEO 


175] DEVICE NANE-3RD CHAR. | DEVICE eae faeces {125 


| 177] DEVICE NANE-7TH CHAR. 


| 22002892828 SS80 828888 ST 8H8 | 29S982022S8S8822OS8SS882 
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Other identifiers used: 


Discussion: 

FLACCTNANE Thie is the account nane of the file. It is eight bytes in 
length with trailing blanks added. 

FLALLOCORTE Date that the file uas allocated on this systen. 

FLALLOC TINE Double-word containing the tine that tre file was allocated 
on this systen. 

FLBLKSIZE This is the block :.ce, in sectors, of che file. 


File Lab nt. 


01234 5 6 7 8 9 10 11 12 13 14 15 
ges Fd Ped es ed eed en oe od od 
CREATION DATE ta FLORERTE 
| oenwnnernennnnnnnnenecnnenenennennenennesensce 
| LAST ACCESS DATE ia FLLASTACC 
| encnccenennenewnnnnnnwen nn cen enennenenencoenere 
31| LAST MODIFICATION DATE 125 FLLASTAOD 


32| FILE CODE 26 FLFILECODE 
33| Cl FVTRBX ! VNASK |27 FLPVINFO 
34] SI Rf Ul sf SUBTYPE | OISC TYPE | R/U J28 FLLOCK 


36] (30 FLFLIM 
| FILE LIAIT | 

ss ie 

40| \32 FLFCBVECT 
| FCB VECTOR | 

41| 133 


42| CHECKSUM 134 FLCHECKSUN 


43) COLD LOAD ID 135 FLCLIO 
“ FOPTIONS 136 FLFOPTIONS 
4a5| RECORD SIZE IN BYTES a FLRECSIZE 
46 BLOCK SIZE IN WORDS 138 FLBLKSIZE 
47| SECTOR OFFSET 7 v i IND. EXTENTS+1 ” 

|40 FLLASTEXT- 

SIZE 

(41 FLEXTSIZE 


51| EXTENT SIZE IN SECTORS 


$2] [42 FLEOF 
| END OF DATA POINTER | 
53] 43 
cAI VOLUME TRBLE INDEX | iv rientne 
55] 1ST EXTENT SECTOR NUNBER [45 


08S OS OO 9 SSS 06 OS 228 2 OSE COS OSE SESS S 28SBLSSSSOSOECO | 
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FLSECURE =z FLAS(22).(15:1)#, file secure bit 
(FLSRRELERSE)= FLAB(22).(14:1)#, STORE/RESTORE released bit 


FLCLASSFLG FLUPVINFD.(0:1)8, Class flag bit 
FLINT RBX FLPVINFO.(4:4)#, Mounted volune table index 
FLYNASK FLPVINFO.(8:8)#, Volune nask 
(FLSTORE ) FLAB(28).(0:1)#, file being stored 
FLRESTORE FLAB(28).(1:1)4, file being restored 
(FLLOAD) FLAB(28).(2:1)@, file loaded 

FLEXCL FLFB(28).(3:1)8, exclusive access 
FLSR FLAB(28).(0:2)8, S&R bits 

FLSRL FLAB(28).(0:3)@, S$, R, & L bits 
(FLSRLX) FLAB(28).(0:4)#, S, R, L, & X bits 
FLSUBTYPE FLAS(28).(4:4)#, device subtype 


FLSTATUS FLAB(28).(14:2)8, urite/read status 
FLAE(29).(0:8)#, no. labels uritten 
FLAB(29).(8:3)4, no. labele available 
FLAB(39).(0:8)%, sector offset to data 
FLAB(39).(8:2)8, file version(>*V-Delta-3) 
FLAB(39).(11:5)8, no. extents less 1 


FLSECTOFF 
FLVERSION 


8 
}-¥ 
3 
3 
. 3 
s 
Zz 
s 
tj 
2 
FLDTYPE = FLRB(28).(8:6)8, device type 

s 
8 
g 
3 
Z 
FLNUMEXTS = = 
3s 

2 

Zz 

8 

3 


FLLABEL FLABDSL(22)#, label VIRB and sector 

FLVTRB FLAB(44).(0:8)#, label VIRB index 

FLALLOCTINE FLABDBL(S4)a, tine allocated on this systen 
FLALLOCORTE FLAB(110), date allocated on this systen 
FLSTART FLABOBL(56)#, starting block nunber 

FLEND FLABDEL(S7)e#, ending tlock nunber 


FLRUNOPENCLSREC FLABOBL(55)e, 
FLNODTINE = FLABDBL(59)#, 
FLPEXT’ADOR = FLABDBL(60)#, start address of pseudo extent 
FLPEXT’SIZE = FLAB(122)#, pseudo extent size 
FLFLAB’EXT’SIZE = FLPEXT' SIZE. (0:8)a, 
FLSEC°EXT’SIZE = FLPEXT’SIZE. (8:2)8 


nunter of open, close records 
last tine file was modified 














FLCHECKSUA 


FLCLIO 


FLDEVNANE 


PLOTYPE 


FLEND 


FLEOF 


FLEXCL 


FLEXTRAP 


FLEXTSIZE 


1133 
1139 
1140 
1141 
1145 
1146 
1147 
1148 
1149 
1152 
1183 
1186 
1157 
1158 
1159 
1166 
1167 
1168 
1169 


1171 
1173 
1174 
1175 
1176 
1177 
1178 
1192 
1193 
1194 
1195 
1211 
1212 
1213 
1214 
4218 
1216 
1217 
1226 
1227 
1228 
1229 


1235 
1236 
1242 
1243 


1245 
1246 
1247 
1248 
1249 
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File Systen 


This is the exclusive-OR checksun of the file label 
(excluding uords 34, 42, and 43 octal) and is used for error 
detection. Each tine the file label is read fron disc the 
checksun is calculated and conpared against the value 
recorded in the file label. Similarly, each tine the file 
label is written to the disc the checksun is calculated and 
inserted into the file label. 


This 18 the cold load nunber in effect the last tine that 
the file was accessed. This should aluays be the current 
cold load nunber. If it is not, 1t neans that the systen 
crashed while the file was open and that the data in the 
file label should be “reset” (principally the FCB vector 
FLFCBVECT). FLCREATE This is the creation date of 
the file. It is in the fornat defined by the CALENDAR 
intrinsic. 


This is the FOPEN device specification that was used when 
the file was created. This infornaticn is needed when new 
extents are allocated. 


This is the device type nunber of the first extent of the 
file: see ACBOTYPE for a list of legal values. This value 
is deternined by configuration. 


Nunber of current data blocks (that is, the end of file 
block nunber relative to the start of file). Valid for 
variable and message files only. 


This is the end-of-file pointer for the file. It is a 
double word integer representing the nunber of records in 
the file. It can aleo be viewed as the record nunber of the 
next record past EOF. 


This is the exclusive access flag for the file. If set it 
neans that the file has been cpened exclusively by a single 
accessor. If not set then the file is potentially 
accessible by others. 


This is the extent nap of the file. The nunber of extents 
is specified by FLNUNEXTS; a 0D extent descriptor indicates 
that the extent has not been allocated. 


This is the extent size, in sectors, of the file. All 
extents in the file, except the last, have this extent size. 
This is a logical value, and legal values range fron 1 to 
65535 sectors. This linits the naxinun File size to 2097120 
sectors. 
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File Systen 


SRAPL APS/3000 Log File 


MPEDL MPEDCP/DRP Log File 

TSR HPToolset Root File 

TSD HPTcolset Data File 
DRAW Drauing File for HPDRAW 
FIG Figure File for KFORAU 
FONT Font File for HFORAW 
a Color Definition File 


SLATE Conpressed SLATE File 

SLATW Expanded SLATE Workfile 

OSTOR Store File for RAPID/3000 Utility DICTOBU 
TCOCE Code File for Transact/3000 Conpiler 
RCOOE Code File for Report/3000 Compiler 

ICODE Code File for Inforn/X00 Conpiler 

ROIST HPDESK Dastribution list 

ATEXT KPDESK Text 

RRRPA ARPA Message File 

NARPD ARPR Distribution List 


MCHND HPDESK Abbreviated Connands File 

AFRTA 

NEFT 

NCRPT 

ASERL 

VCSF 

TTYPE Tern Type File 

TVFC Tern Vertical Fornat Control File 

NCONF Network Configuration File 

NTRAC Network Trace File 

NLOG Network Log File 

MICAS 

NDIR ANODE 

INODE INODE 

INVRT 

EXCEP 

TAXON 

QUERF 

oOcoR 

vc VC File 

OIF OIF File 

LANGO Language Definition File 

CHARD Character Se* Definition File 

RGCAT Fornatted Appiizstion Nessage Catalog 
Reserved 

BnRP HAP File 


BORTA BASIC Date File 
BFORN BASIC Field Order File for VPLUS 
BSAVE BASIC Saved Progran File 


tg Config. File for defauit Option BASIC pregran 
BKEY 
NFBSU Business Basic/XL Progran File 
NMBOT Business Basic/XL ATA File 
ChBEN Business Basics ~irary file 
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FLFCBVECT 


FLFILECODE 


1024 
1925 
1026 
1027 
1028 
1029 
1030 
1031 
1032 
1033 
1035 
1036 
1037 
1040 
1041 
1042 
1050 
1051 
1052 
1054 
1055 
1056 


~~ 
S 
mn 
oe 


File Systen 


1258 


1276 
1421 


1428 
1431 


1435 


ot 
> 
&) 
Ged 


_ 
on 
—_ 
> 


FLFLIA 


FLFOPTIONS 


If nonzero, this is the vector of the FCB for the file. If 
zero, the file is not being accessed. 


This is the file code of the file. Knoun values are: 


Filecode finencnic 


USL 
BASD 
BASP 
BASFP 
Ru 
PROG 
NAPRG 
SL 
NAXL 
NFIRL 
VFORA 
VFAST 
VREF 
XLSRV 
KLBIN 
XLDSP 
EOITG 
EDTCQ 
EOTCT 
TOPOT 


L0123 
FTICF 
DSKIT 


Explanation 


User Subpregran Library 

Basic Data 

Basic Progran 

Basic Fast Progran 

Relocatable library 

Progran File 

Native Rode Progran 

Segnented Library 

Natave Mode External Library 
Natave Node Relocatable Library 
View Forn File 

View Fast Forns File 

Vieu Refornat File 

Cross Loader ASCII File (SAVE) 
Cross Loader Relocated Binary File 
Cross Loader ASCII File (DISPLAY) 
Edit Quick File 

Edit KEEPQ File (COBOL) 

Edit TEXT File (COBOL) 

TOP Diary File 

TOP Proof flarked QMARKED 

TOP Proof Marked non-COB80L File 
TOP Proof Marked COBOL File 
TOP Workfile 

TOP Workfile (COBOL) 

RJE Punch File 

QUERY Procedure File 

KSAN Key File 

GRAPH Specification File 

User Legging Log File 
Self-describing File 

HPUORD Docunent 

HPUORD Hyphenaticn dictionary 
HPWORD Configuration File 

KP 2601 Envirennent File 
1DS/3000 Character Cell File 
I0S/XOO Forn File 

IFS/3000 Environnent File 


Graphics Inage in RASTR Fornat 
OPT/3000 Leg File 

TEPE/3000 Script File 
TEPE/30OO Log File 
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Pathflow STATIC File 

Pathfiow DYNAMIC File 
Revisable Forn OCR Cocunent 
Final Forn OCA Docunent 
Docunent Interchange Unit File 
HPUORD/150 Docunent 


HPARP/3000 Nap Specification File 


HPBRU Dictionary File 
KPBRW Execution File 


Tag Inage File Fornat 

Revisable Docunent Fornat 

Serial Object File Fornat 

Chart File for Charting Gallery Chart 
Data File for Charting Gallery Chart 


Fornatter 


Dunp File 

New Wave Mail Distribution 
%.400 Header 

Other UP 

Other UP2 

Lotus 123 Spreadsheet 

Forns tester Crd Spec 

HPOesk Intrinsics Transaction 


Reserved for RPL 


This is the end-of-space pointer for the file. It is a 
double integer representing the maxinun nunber of records 
(fixed length record format) or blocke (undefined or 
variable length record fornat) in the file. 


This ie the FOPTIONS of the file. 
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FLGRPNARE 


FLUABEL 


FLLASTRCC 


FLLASTAOD 


FLLASTEXTSIZE 


FLLBL 


FLLBLEOF 


FLLORD 


FLLOCK 


FLLOCKWORD 


FLAODTINE 


FLNUNEXTS 


FLNUROPENCLSREC 


FLSR 


FLSRL 


FLSRLX 


FLSRRELEASE 


FLSTART 


FLSTATUS 


FLSTORE 


File Systen File Systen 


This ie the group nane of the file. FLPEXT’ROOR 


It is eight bytes long 

with trailing blanks edded. 

This is the volune table index and sector nunber of the file 

label, which is the sane as the first extent descriptor. 
FULPEXT’ SIZE 

This is the last sccess date of the file. It is in the 

fornat defined by the intrinsic CALENDAR. 

This is the last nodification date of the file. It is in 

the fornat defined by the intrinsic CALENDAR. 


This is the size, in sectors, of the last extent in the 
file. If the file has one extent, then this is the sane as 
FLEXTSIZE; if the file has nore than one extent, then this 
value may be different from FLEXTSIZE. This is the size of 
the last physical extent for the file; it is not the size of 
the last allocated extent. 


FLPVINFO 


FLRECSIZE 
This is the nunber of user labels allocated for the file. FLRESTORE 
Since each label is a sector long, this is also the nunber 
of sectors allccated for user labels. 
This is the end-of-data pointer for the user labels. It is 
analogous to FLEOF in that it represents the nunber of 
labels written. 
FLSECAX 
This is the LORDED flag for the file. If set, it means that 
the file is a loaded progran or SL file and cannot be 
nodified except by a privileged accessor. This flag is set 
and cleared by the loader, not the file systen. 


This identifies the uord containing the lock bits, uhich are 
described separately. FLSECTOFF 
This is the lock word of the file. It is eight bytes long 
with trailing blanks added. If it is all blanks, then the 
file does not have a lockuord. FLLOCNANE This is the 
local nane of the file. It is eight bytes long with 
trailing blanke added. 


Last tine the file wae modified. 


FLSECURE 


This is the nunber of extents, less one, allowed for the 
file. It is not the nunber of extents allocated. Legal 
values range fron 0 to 31, i.e., 1 to 32 extents. 


Nunber of cpen and close records in the nessage file. 
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File Systen File Systen 


This ie the STORE snd RESTORE eg for the file, which are FLSUBTYPE 
described separately. STORE and RESTORE decode the tuo-bit 


field to indicate their operation. Legal values are: 


0 - file not in use by either STORE or RESTORE 
1 - illegal value 

2 - file being STOREd 

3 - file being RESTOREd 


FLUSERIO 
FLUSERLBL 


The file systen interprets the leftnost bit as indicatin 
that the file is being accessed by either STORE or RESTORE. 
The rightnost bit is interpreted as indicating what access 
should be pernitted: O (file being STOREd) allous read 
access; | (file being RESTOREd) allous no sccess. This 
field is set and reset by STORE/RESTORE, not the file 
systen. 


This is the STORE, RESTORE, and LORDED flags for the file, 
which are described separately. 


This is the STORE, RESTORE, LORDED, and exclusive flags for 
the file, which are described separately. 


This flag is used by STORE/RESTORE. If a file is STOREd 
with the ";RELEASE" keyword, STORE will set this flag in the 
tape copy of the file label. RESTORE will allow any user to 
access such files, regardless of the file’s nornal security. 
If this bit is off in the tape copy of the file label, 
RESTORE applies normal security checks (as defined by the 
infornation in FLSECNX and FLSECURE). This bit is zero for 
files on disc. 


FLVERSION 


FLVTAB 


Block nunber of the file’s start, excluding the file label 
block. Valid for variable and nessage files only. 


This ie the read/urite status of the file. 
are: 


Legal values 


0 - no accessors 
1 - read 

2 - write 

3 - read/urite 


This is the STORE/RESTORE flag for the file. If set it 
neans that the file is being either STOREd or RESTCREd. 
The RESTORE bit (FLRESTORE) must be interrogated to 
determine which cperation ie taking place; see FLSR for 
a full description of the use of these bits. This flag 
is set and cleared by STORE/RESTORE, not the file 
systen. 
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This is the device subtype nunbder of the firet extent of the 


This has the disc address of the start of the pseudo extent 
(ACD) that has been attached to this file. The high order 
byte contains the volune table index, the renaining 24 bits 
contains the sector address. 

This word holds the size of the pseudo extent. It is broken 
up into tuo halves of one byte each. The high order byte 
holds the saze of the file label extensicn(not currently 
inplenented), and the low order byte contains the size of 
the ACD (security extension). Both sizes are in sectors. 
The pseudo extent 18 partitioned into tuo extensions, with 
the security extension always appearing first, and the file 
label extension appearing after. 





File label private volune information. This is in the sane 


fornat as the FCBPVINFO. 
This is the record size of the file in negative bytes. 


This is the RESTORE flag for the file. 
that the file is being RESTOREd and cannot be accessed. 
RESTORE also sets the STORE bit for the file (FLSTORE); see 
FLSR for a full description of the use of these bits. This 
flag is set and cleared by STORE/RESTORE, not the file 
systen. 


If set, it neans 


The bits are 
(Bits 0:2 are 


This is the security natrix of the file. 
organized into five groups of six bits each. 
not used. ) ee gee correspend to the access types: READ, 
RPPEND, WRITE, LOCK, and EXECUTE. Within each group, each 
bit specifies who nay have the access: ANY, ACCOUNT FGR, 
ACCOUNT LIB- RARIAN, GROUP, GROUP LIBRARIAN, CREATOR. 


This is the sector offset fron the file label to the first 
block of the file. This is not necessarily equal to 

FLLBL¢1 since an integral nunber of blocks are allocated for 
the file and user labels. 


This is the file security enforcenent flag for the file. If 
not set, then the file has been RELEASEd and the security 
matrix FLSECNX should be ignored. If set, then secure as 
specified by the security natrix. 
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file. This value is deternined by configuration. 
This is the creating user nane of the file. 
bytes long with trailing blanks added. 


This field describes the user labels of the file. It 
consists of FLLBL and FLLBLEOF, which are described 
separately. 


It is eight 


Starting with V-Delta-3, this field specifies the RPE 
version that a file uss created on. Legal values: 
0 - a file created before V-Delta-3 
1- a file created on or after V-Oelta-3 
2,3 - currently undefined 


nie is the volune table index of the first extent of the 
ile. 
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File Systen 


i-Access Vector Ta FRRVT T 


Hy 


The FNAVT is used to locate shared PACEs for files opened nulti-access. Uhen 
an old disc file has been opened nulti-access, the FRAVT is searched to 
deternine if the file has previously been opened. The JITOST and the ORDOR 
found in the FHAVT are conpared to the JITOST of the job and the DADDR of the 
device or disc file being opened nulti-access. If an entry exists for the 
file, then the PACB can be easily located for that file. If this is the 
first process opening the file, then an entry 18 created and inserted into 
the FARVT for the file. 


Spoolfiles are opened nulti-access, therefore, they will have entries in the 


FRRVT. $STOIN and SSTDLIST also have entries in the FAAVT since they too are 
opened nulti-access. 


Zero Entry Forma 


| ----nnnwcnnnnnnnncweonnnnnnnscennnnoncnennnnnnccen| 
CURRENT TASLE SIZE ° Fn°curr’ SIZE 
| ENTRY SIZE = 6 [4 Fr’ ENTRY’ SIZE 
| MAXIAUN TABLE SIZE : FA’ MAX’ SIZE 
| 0 {3 
|------- wonwnnnnnnnnneneennnnannenennnne onnnocnen== | 
| 0 14 
| ------sencennmnnnnnnnnnnnnncnnnnnnnnnnnnennns ------| 
| 0 15 
|--enee-nonennncnnnnnnrnnnnocennannnennnacenmncenenn| 

Descriptions: 


FR’CURR’SIZE The current size of the FAAVT in words. This value increases 
in ancrenents of Z200 words until FA’MAX’ SIZE is reached. 


FA’MAX’SIZE The naxinun allowable size in words that the FA’CURR’ SIZE can 
get. The current value of this is 274000. FA'MAX’SIZE can be 
changed only by changing the code in Initial. The open of the 
nulti-access file is failed if this naxinun is reached. 


FM’ ENTRY’SIZE Size in words of an FRAVT entry, 6 words at present. 
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Systen Global Area (SYSGL08) 


The file systen uses several uords in the systen global area for its oun use. 


SHFCBDST SY$08+Z76, shared CBT DST no. 

MONITOR SYS08+Z77, nonitoring flag word 
MAXSSECT SYS08+Z100, sax W spoolfile sectors 
NUNSSECT SYS0B+Z102, current @ spoolfile sectors 


SPOOLINDEX $¥$08+Z132, clase spool index 

CSIOWATT $YSD6+Z135, CSIOWAIT PLABEL 

CCLOSEPLABL S¥S08+Z140, CS CCLOSE PLASEL - FPROCTERN 
OSCHKPLABL S$YS08+Z335, DSCHECK PLABEL 

DSOPENPLABL $YSD8+2%336, DSOPEN PLABEL 

OSCLOSEPLABL = SYS08+Z337, DSCLOSE PLABEL 

SDSLOEVLABEL = SYS08+%323, PLABEL for SOSLDEV 
MANUCPLABL = SYSDB+Z340; MANAGEWRITECONV PLASEL 
GLOBALAFTDST © SYSGLBEXT+Z121 Global AFT DST nunber 


s 
s 
s 
8 
EXTSSECT s SYS08+z104, @ sectors/spoolfile extent 
a 
s 
8 
8 
s 


cks, an 


The file systen uses tuo SIRs: the File SIR, which is intended to protect 
file label integrity, and the FNAVT SIR, which is to guarantee the integrity 
of the FAAVT. Since the file systen locks these resources and also locks 
control blocks, deadlocks can occur if locking is done in the urong order. 
Not only nust the file systen handle locking correctly, but the entire 
ensenble of the file systen, its callers, and its callees nust do so also. 
These include KSAN, which has a SIR of its oun, SYSOUMP, and STORE, which 
lock the File SIR because they tweak bits in file labels. The presently 
accepted order is: 


Get FHAVT SIR 


Lock FCB 


It may not be necessary to do all of these things in any particular 
procedure. In modifying a procedure, you should be sure that any of these 
locks which you change are consistent not only within your oun code, but also 
with its callers and callees. 
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Typical Entry Fornat 


| 0123.4 5 6 7 8 $1011 12 13 14 15 
| Joe ]o=fo=|-- foe }-nl--l--I--1--1--b-l--l-- --|--| 
nee 
| JIT OST i Fn JITOST 
| | -nnnnnnonnnsocenneesoee | enenneneeen reese weoceee 
| LOGICAL DEVICE }2 FR’ DADOR 
| DISC ADDRESS \3 
|4 Fn’ PRCBV 
| PACS VECTOR A 


FR’DEVICE © FRAVT(O).(2:1)8, Device bit 
FA’GLOBAL = FRMAVT(O).(1:1)8, Global nulti-access bit 
FR’ LDEV 2 FN'DADDR(O).(0:8)", Logical device nunber of file 


Descriptions: 


Fn’ ORDOR The disc address of the file label for disc files. For device 
files, the disc address is zero. 


FN’ DEVICE This bit is 1 for device files and 0 for disc files. 


FA’ LOEV Logical device nunbder of device files or the LOEV of the disc 
containing the file label for disc files. 


FA’ JITOST The DST nunber of the JIT for the job that has the file open. 
If this field is nonzero, then only processes in the fanily 
tree of this particular job can open the file. This field is 
zero if the file was open global nulti-access. 


FR’ GLOBAL This bit is 1 if the file wae opened global nulti-access, this 
allous nulti-access to the file betueen jobs. 


Fn’ PRCBV The PACB vector for this nulti-access file. Used to easily 
find the Physical Access Control Block for files opened 
nulti-access. 
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In sysglobal 276 (ABSOLUTE 11076) there exists the shared Control Block Table 
DST nunber. This OST holds a list of shared CBTs. Shared CBTs are used to 
keep any and all file systen control blocks that have the potential to be 
shared between processes. Any disc file cpened shared will have its FCB kept 
in one of these CATs. Also, all terminal PAC8s will be stored in a systen 
shared CBT so that an extra data segnent is not wasted. This is possible 
because all terninal access is perforned NOBUF, which means that the PACB 
will be a nininal PRCB and can be placed in these C8Ts. Lastly, any file 
opened with global file access will have all ite control blocks placed into 
these systen COTs. 


The fornat of the eysten shared C8T OST is sinilar to a Control Block Table. 
It has the sane uords of overhead and the data (the list of DSTs) starts in 
the next word after the overhead. The systen C8Ts are created one at 3 tine 
as needed. Usually, there are only a few DSTs in the list. 








| si TABLE SIZE IN wae 6 
: Geese TE 
1 2a 0 le 
1 3 0 an 
a) 4: Ge | 
Seg ee {5 
7 a ne 
A tg ee ly 
| 40} IST. SHRRED CBT OST NUMBER \s 
| tt aN. SHARED COT DST MUNBER i9 
| a ae 

rey ene reer nee | 
ey ck ee 
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CHAPTER 7 PROCESS TABLES P f Forn 
| -eceeennonnc---e= wacccowcecce a ecccennencee 
The operating eysten maintains state, control, and accounting information on } oO @ OF CONFIGURED ENTRIES 10 
each process. The data structures for this purpose are the process control | cewewcwnerncncencnwccnneerrnenecsconnmoserorere | 
block table (PCB; core resident, 1 entry per process) and the process control 1 1 ENTRY LENGTH (Z25) \1 
block extension (PCBX; contained in the process’ stack below OL). Process jg | |. _—— _J[seeeeerereccosers eneccoorcoowsconnoononwscoorr= | 
related information uhich must be accessible uhen the process’ stack is not 1 2 # OF UNASSIGNED ENTRIES {2 
present in main nenory 1s maintained in the process’ PCB entry. All other |eos-- wnccnccoocor= woccceroccoccronnerercowowern | 
process related information is maintained in the process’ PCBX. } 3 TABLE RELATIVE INDEX TO FIRST 13 
{ UNASSIGNED ENTRY | 
A process is identified in the systen by its PCB entry nunter, referred to as | enenannnnnonnnnnnnnneennnnesennenesnnnn amen nnn= | 
its PIN (process identification nunber), or by its PCBPT2(PIN)*(PCB entry } 4] TRBLE RELATIVE INDEX OF LAST |4 
$1ze). FREE ENTRY 
The structure of the PCB table, PCB entry format, PCBX structure, and PCBX | §] HIGH WATER MARK ; {5 
fornat are specified in this chapter. | coco men wn nnn neon cence nnwecenennensnoceerneceer= | 
{ 6] NUMBER OF PRIMARY CONFIGURED 16 
| ENTRIES (0) | 
Process Cont k Table St and Forna | enewererenneneewncen nnn nenennn nena ceennenernan= | 
} 7 HEAD OF IMPEDED QUEUE PCB RELATIVE INDEX {7 
Fixed Cells Related to PC —, aa | 
| rol TAIL OF IMPEDED QUEUE PCB RELATIVE INDEX [8 
| ABS(4) PCB relative index of current process’ PCB entry | 41] NUMBER OF CURRENTLY INPEDEO PROCESSES \9 
21003 SYSGLOB relative address of the PCB table base | co wene ween nnn conn enncccnnnnennnsconnccceseoce o-| 
The bank & address are represented as per the MPEV ERS. } 12] NUMBER OF MAXIMUM IMPEDED PROCESSES 110 
Z1271 PCB relative address of head of dispatching queve's PCB | (CURRENT) | 
entry fencer ee oonnceere. 
21272 PCB relative address of tail of dispatching queve's PCB } 13] CUMULATIVE NUNBER OF IMPEDED PROCESSES = |'11 
entry } (CURRENT) 
| "| 0 {12 
| a | 0 )13 
| 16) 0 "4 
| "I 0 "5 
| aa 0 "6 
| at 0 \"7 
} 22] 0 18 
| 23! 0 "9 
| 24] 0 120 
6.23.00 6.23.00 
7-1 7-2 
Process Tables Process Tables 
nassianed P n Forna Assianed P n 
| eomno wn n nnn eeewnennenncce cocececenn| 012 § 6 7 8 9 10 11 12 13 14 15 
| of 0 lo |o-|--l==|=-]-=1--] =| =-]--l-=]-- fo“ -= |---| 
| ween wnnnn-- ne nen enn nn an ne conn non ecennnncosneee=| is {8 JC (H {P [H IT IP JD IL IS IT JU IH IS IR | 
| 1 TABLE RELATIVE INDEX TO NEXT UNASSIGNED [1 jA JF IRIS Iz {s 1? ic IS Ju du ik IS IT IT IT | 
| ENTRY | Ola | IZ Ir JO iP JE} JOt | IW IE IP 10 IT [RESABCRTINFO 
Jocororeerecccecees-senenne coeee conen-| it tim ivin ix? Jet ft ot lok Iv fet 
. LA a a 
- - 1] SLL RELATIVE AODRESS GF PROCESS’ SEGRENT |SLLPTR 
coc eesecrer cen nerenwnnnecoson wewweccceccncesoe=| | LOCALITY LIST 
| 24] 2177777 \2 Pa i i wommet 
a { EXTRA BATA SEGRENT’S OST [POKOSINFS 
Note: Only werd 1 and word 20 are valid for an unassigned PCB entry. aie woccce convent 
a} hea DST ENTRY # FOR PROCESS’ STRCK ISTRINFO 
|--|--|--------= weewcrnennannnnn-———=-| 
In IR IRIN (BIT JU IS IP YM IS IF IX 1S 17 1A | 
4) IG JL IA IZ JO JC IW IA YS JO IA Im IT IT (E [UAKENASK 
i td io) tw IG In] JP IR IA in 
5 FATHER'S PCB INDEX |FATHERINFO 
“ SON'S PCB INDEX |SONINFO 
"| ere pce mer |BROTHERINGO 
| iw | 1D JF IS | 
| $s] JE JA IE | 
|} 10) PSIN JO | GA IA IC IR UNUSED |PIINFO 
F ° i ivi | 
TI } 1€ | ( 
ol = |==}--]--}-=]--1--|-- 1-1] = l= 
{L | is | ii tttetdtd 
11/I | GAS | PPC 10 | PTYPE [SIJHKISK|STIHBICY|EK|PROCSTATE 
iv | \v | itbitru dda 
Jo | none | -mnne [on] emmnnnn= J o= |o= | -- | --1--1--1--1 
Mal EVENT FLAGS LUSIEVENTF LUNGS 
. "a SEGIDENTIFIER OF LAST REFERENCED | LASTREFCODESEGO 
{ “ \e-4 eet CODE SECRENT | LASTREFCODESEGY 
jo Iu IC ID JE Iz Ic tA | | 
iriai | ¢ IN tots] | 
sis} | | J irik ie) PRIORITY | QUEUE 2NGINFO 
eid dt d te te IF I | 
lai | fd RU ITI | 
ny el Dead Cd Cee | 














Procese Tables 


Assianed P ntry Fornsa Cont. 


| 
16} 
17| 
| 
20| 
| 
| 
23| 
| 
| 
22| 


l- 
23| 
[ 


\- 

24| 
| 
\- 


cwewuaccccecensccscccccenscccscercescecsoceccce | 
INDEX WITHIN CSTBLOCK TABLE (CSTBLK) | PEXUCRONUN 
LOGICAL SEGHENT TRANSFORM TRBLE |MAPDST 
(LSTT) OST @ 
| eecenenanreneencnnecanncsernesenceeanensesnsnns 
ADDRESS (PCB RELATIVE) TO PREVIOUS |PINPPIN 
IMPEDED PCB | 
ADDRESS (PCB RELATIVE) TO NEXT |NIMPPIN 
INPEDED PCB | 
BREAKPOINT TABLE RELATIVE ENTRY ADDRESS {| BPTLINK 
ROOR (PCB REL) OF NEXT PROCESS (NGPTR 
IN SCHED QUEUE ! 
ADOR (PCB REL) OF PREV PROCESS |PQPTR 
IN SCHED QUEUE 
.(0:1) SAR - scheduling attention required 
.(1:1) Bounds Flag - Privilege mode bounds check 
.(2:1) CRIT - process is critical or with SIR 
.(3:1) HSIR - process has a sir 
.(4:1) PIOVR - pseudo interrupt happened uhen process had 
SIR or was inpeded 
.(531) HSPRI - hold sir priority 
.(6:1)  IPEXP - incore protect expired 
.(7:1) PC + pre-enpt capability 
.(8:1) OSOFT - Delayed soft int processing. A pending 
soft int cannot be processed because of sir 
or critical state. PSEUDOINT will be invoked 
when these condition(s) go away. 
-(9:1) Ul - long uait 
-(10:1) SW - short wait 
-(11:1) IRM = terminal read usit 
.(12:1) USEOQ - used a quantun since transaction began 
.(13:1) HIPRI - don’t alter priority 
.(14:1) STOVA - process aborting due to stack overflow 
.(15:1) RITBK - Request Infornation Table Break 
(e.g., message auaiting operator response) 
.(0:16) SLLPTR, SLL relative index to process’ segrent 


PCBO1 


PCBO2 


| PCB11 


PCBI2 


PC813 


locality list 


.(0:1) ADB, set if 08 pointing to an absolute address 
.(2:14) XDS, OST entry nunber of extra data segnents to which 
DB is set; zero if none. 
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.(0:1) — LIVE, set if process is alive 
(1:2) BNS, bleck nail, valid if MA set 
0: sent to father 
1: received fren father 
2: send to sca 
3: received son 
.(3:2) PRC, process to process conmunication, set with 
respect to son 
0: null 
1: son to father 
: father to son 
3: blocked 
) STOV, abort - stack overflow has cccurred 
)  PTYPE, process type 
0: user 
4: user, son of nain 
2: user, main 
3: user, main, task 
4: systen 


" 


S: systen, UCOP 
.(9:1) SI, set when the Dispatcher (and PSEUOOINT) 
should be auare of a pending soft interrupt 
-(10:1) HK, hard kill pseudo interrupt 
(11:1) SK, soft kill pseudo interrupt 
.(12:1) ST, stop pseudo interrupt 
.(13:1) #8, hibernate pseudo interrupt 
.(14:1) CY, Control-¥ peeudo interrupt 
.(15:1) 8K, break pseudo interrupt 


.(0:15) | EVENTFLAGS, one for each wait class in PCBO4 
.(15:1) US, wake up waiting suitch set if an auake is 
nissing (i.e., the event occurred before the process 
has a chance to wait for it) 


-(0:32) LASTREFSUAPSEG, se t identifier of last 
referenced euappadle code sequent 
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Process Tables 


(15:1) 
PCBOS. (0:16) 
PCBOG. (0:16) 
PCBO7. (0:16) 

| PCB10. (0:3) 


(3:1) 
(4:2) 


- (63:1) 
(7:1) 


| (8:1) 


Process Tables 


PCB15 


e e e s . o e 

IRN OO 
es 8 08 @e 80 88 @2 OF 
Dd ot ad od od od ot wt 
ee et Nea? Nel Sea? Nel? Sena? a? 


. (8:8) 
PCB16. (0:16) 
PCB17. (0:16) 


| PCB20. (0:16) 
| PCB21. (0:16) 
| PC822. (0:16) 
| PCB24. (0:16) 
| PCB25. (0: 16) 


STOVRALL FLAG - stack overflow is already allocated 
SC, set if executing systen code 
DST entry nunber of process’ stack 


N, nourning uait 
RG, global RIN wait 
RL, local RIN wait 
MA, mail wait 


B10, 


blocked on 1/0 uait 


TO, 1/0 wart 


SON, 


UCOP wait and RIT wait 

junk wait 

tiner (pause) wait 

file systen basic IPC nessage wait 
son wait 


FA, father wait 


In, 
SIR, 
TIA, 


nen, 


FPIN, 
SPIN, 
BPIN, 
PSIA, 


ne Bh) 
ee e@ 60 G@@ 8 © 


process waiting to be uninpeded 

process waiting for a sir 

process waiting for a tine out (set up by 
systen to prevent a process hang due to a 
possible "lost" event) 

process waiting for nenory 


father’s PCB relative index 
gon’s PCB relative index 
brother’s PCB relative index 


pseudo - interrupt node 
hard kill 

soft kill 

stop 

hibernate 

escape (Control-Y) 
break 

nornal 


73 a 
WSOFT, OK for soft interrupt to wake process 


even 


though it is waiting on another event 


OR (origin of activate) 


0: 
t: 
2: 
3: 


other source 

father 

son 

reply done on RIT wait 


DEAD, set during expiration 


FAC, 


if eet, the father is to be activated on process 


ternination 
SERVE, if set, this process is a DS SERVER process 


6.23.00 


(QUEUING INFO) 
DISPQ - dispatcher’s scheduling queue 
L scheduling class 
C scheduling class 
D scheduling class 
E scheduling class 
INTER =- process is interactive 
CORER - process is core resident 
ASOFT, Allow soft interrupt (A value of 1 
inplies that user soft interrupts will be 
processed. A zero value inhibits user soft 


ints 


(they are queved). This bit is managed 


by FINTSTATE and FINTEXIT intrinsics. ) 
Process’ scheduling priority 


PBX, 


CSTX block nap index of process’ progran 


MAPDST, DST entry nunber of the CST napping 
table 


PINPPIN, PCB relative index of previous inpeded PIN 


NIMPPIN, PCB relative index of next inpeded PIN 


SPTLINK, breakpoint table relative entry addrese 


NOPTR, PCB relative index of next proc in disp queve 


PQPTR,PCB relative index of prev proc in disp queve 
queue (= -1 if process is not alive) 
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p n k Extension (PCBX} St nd Forna 
n k Extension (PCBX 


| ------nn--2222---ece-oneoe" no===-1\ 


a--->] ss DL-a = SEG. REL OL VAWE | \ . 


| 

| 
| | PXGLOB si 
| | | 
| {/ | 
 Keoceratetetatatetatananetauneieaneieaiebesanel coececce| / | 

b--->| c-b 2 PAFIXED LENGTH i\ | 
|ooccee ween nscconenoecwcre cocccccee| \ | 
| 1 | | 
| | oe | 
| PXFIXED EXPANSION AREA | > PRFIXED | 
| nap | | 
| (4 words) 1 | | 
 tetetetentteratiatatetettatetanatatatatataatareeeeaanetane | | 
fy | 
; PXFIXED EXPANSION ; 
| ! / PCBX 
|--a-cecennencnnnewennnennnnnenne= | / SIZE 
c--->| d-c = PXFILE LENGTH \ 
| poeen nnn nnn en en noe wnnnnreceocons I\ 
| i | 
| } | 
Jooenee coccoccccccconsnne soceccocre| | 
s) I ; PHFILE 
' EXPANSION/CONTRACTION i 
| | / 
| 


d--->| COUNT OF SECTORS ALLOCATED | 
| FOR PKFINED EXPANSION | 


' 
4 
4 
¢ 
¢ 
8 
¢ 
 ] 
¢ 
8 
4 
é 
a 
a 
§ 
a 
8 
t 
§ 
a 
Q 
4 
6 
~— 
ae ce cs re we ce ce we we ee en er ee ee 


| Ol-c | 
|aeeccanenncennesnsennnennnnnnens| 
i DL-b | 
| OL-a 
DL-->| | 
| | 
| cowewwwemecnocrcowcces eoccencones | 
DB-->| i) 
6.23.00 
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PXFIXED Assigqnnents 


The PXFIXED portion of the PCBX contains epecifie information and control 
infornation. 


0123 4 5 6 7 8 9 10 11 12 13 14 1§ 
|==|==]-=|==1-n]--lon|-=1-=f-el-n dont 11d 
0| C-B PRFIXED SIZE 


1] RELATIVE S(S-08) " 
2] RELATIVE 1(2-D8) 2 
3] DB to NORGUE’s 0-4 13 


| | 
4| INITIAL RELATIVE OL (D8-DL) |4 Uf MOST existed 





S| GENERAL RESOURCE CAPABILITY 15 Trap Modes 
| ie PROG-FILE) oAT(0:1)-Arith. 
|--[--|--]--]--]--f--|-*|--l--|--l--f--fenfenfeel LT(1:1)-Library 
SIATILTISTICVICT] | f | [U YL IC 1G IR [UNILPIG .$T(2:1)-Systen 
Jo-|--]--|-- |-- J --f--]o-]en oo l-ofenfenfeefoefoe|  .C¥(331)-Ctrl-¥ 
7| LINK TO KOS ENT'S IN EXP area | NDS CNT {7 <c1(4:1}-Code 
| -- [on] -----enennnn ne nenne re nonenene | === o-----=-| U User UDC exist 
10] Pi S| EXTRA DATA SEGHENT OST INDEX \8 t Loggi 
Jon |-= |] -- ene ne ncmeererecnennnenenenccccenccese| € Share Clock 
11] Pl SI EXTRA DATA SEGHENT DST INDEX 19 G Glebal RIN acquired 
Jan | -+ |-nennnnene nnn wnnnnencrcnoencnccecccccccs| A Aect UDC exist 
12] PL Si EXTRA DATA SEGHENT DST INDEX 110 / 0:1 RESERVED FOR 
Jo= | ~|o-nenenen onan nnnncnenenee o------ | | _ CST EXPANSION 
12{ Pl S$] EXTRA DRTA SEGNENT OST INDEX {11 | 431 8 1 IF ABORT 
| -- on |- noone een en nnn |-- | en ceneecncencccccoowoce | IN PROGRESS 
14] Xf Al ABORT Y |RUI INITIAL CST INDEX |12 < 7:1 2 0 IF HAVE 
el el eeeeeerennd bel ponnrecentonerenmones R/U ACCESS 
1S| AAXINUN STACK SIZE (MAXDATR LIMIT) {13 TO PROG FILE 
a aan weceencconce=-| | 8 1 OTHERWISE 
16] ARITHMETIC TRAP ENABLE MASK 114 | 8:8 © CST @ OF SEG 
woe nn ne newer enen new nce nen nnenenneenenee od | INITIALLY 
17! ARITHMETIC TRAP PLABEL 115 | EXECUTED AT 
ead | { AT PROC- 
LIBRARY TRAP PLABEL ag \ CREATION 
21] SrSTEM TRAP PLABEL \17 
2z | CONTROL Y PLASEL hg 


NOTE: The Gereral Resource Capability Word (%5) in the PXFINED 


area is used by HP Business Basic. Please inforn then 
when naking any changes to it or to its’ location. 
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Process Tables 


PX: Forna 


The PXGLOS portion of the pcbx is for job information, and contains the sane 


job related infornation for all processes belonging to the sane job. 


i 123 4 § 6 ie 8 3 10 hs ahaa 
EXPAND TO DISPLACEMENT FROM PCBX TO OL ” 
1] EXPAND TO DISPLACEMENT FROM PCBX TO DB " 


2] USER ATTRIBUTES (See JIT’s UCAP uord) i. 


3] MAT "INDEX | [3 
gai a 
Jama 1; 
cise Rf tv | OL Tica | | | STACK oun FURGS|6 
fol ool ve LANGE I? 
cc EA s 
a ceo. , 
ene 
a ee Lis 


= restart bit 
s job in/list interactive 
z job in/list duplicative 


Stack Dunp Flags 
Bit 10 = Arned 
Bit 11 = Suppress traceback 


TY = job type Bit 12 = Suppress ASCIT 
Bit 13 = G-63 to S 
® session Bit 14 = QINIT to S$ 
= job Bit 15 = OL to QINIT 


S task 

= reserved: 
Bf = stun bit ; used for stack underflow simulation for ICF44 or ICFSS. 
GA = Global Allow bit 


R 
I 
0 
Y 
0 #8 undefined 
1 
2 
3 
Ps 
$ 
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xF Aseiann 


| 9099 OS OS 080 OS.8 8889S S08S9SSOE988ES8SEEE4E080EL068 608 | 


23) CODE TRAP PLABEL 119 
24] DATA COMM TERMINATION TRAP PLABEL [20 
2) IMAGE TRAP PLABELSt*~<“i‘:S*‘* 
“| uN ie 
| CURRENT Fa STRK SIE 
| (LARGEST VALUE EVER FOR Z-DL) t 
20] PROCESS ELAPSED CPU TINE ha 
31| (NSEC) fe 


32| MAXIMUM DATA SEG SIZE USEO(IN SECTORS) {26 


9900S C08 BOS SSC SOE OSS BOS OSS 246 SES SOBS4E80 6 TOK O2ECS® 


33} TOTAL VIRTUAL STORAGE USED(IN SECTORS) |2?7 


| CURRENT EXTRA DATA SEGHENT SPACE |28 
ss RANITUN EXTRA BATA SEGREAT SPACE 
6, RIV MODESTO COUNT «30 
| BOUNDS FLAGS | | 
Wo mene a sl 
| (IN MSEC) | 
el ei Merien. 132 
iil cone Lae Ceoime cones) 3 
a Gene ioe 
| RLLOCATED TO STACK | 
43) ERROR LEVEL pant PON e a eed ee Ferry [35 
“Meas bs 
‘Unni 7 
i fF 
a ee 9 
ee a5 
“i Memes f 
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Process Tables 
PXFIXED Assiannents (Cont. 


| 01234 85 6 7 8 910 11 12 13 14 15 
52| ISLR, VIRTUAL TINE SINCE LAST 
| RESCHEDULED | 


| POO 0 0 0 0000 6 000 8 280888 08S SSC OS SSO RO DATO SOOS 


§3] TSTB, VIRTUAL TINE SINCE TRANSACTION |43 
BEGAN | 


54|  TSSUAPIN, VIRTUAL TINE SINCE SUAPIN [44 
55| TSA, VIRTUAL TINE SINCE LAST ABSENCE [45 
56] TSLD, VIRTUAL TINE SINCE LAST 146 
| OEALLOCATION 
| 080800 O06 2 008 0000806 CS SSHS SOS DSO SOS CCC 
57| _QCNT, # TINES TRANSACTION EXCEEDED 147 
THE AST r 
PN ee a ectccecacneemeseenenenstesnnten | 
| e| 10} 101 RESERVED FOR FUTURE SOFT }48 
i | icf ist INT USE 
ee | 
61] TRLX INDEX FOR KERNEL TIMEOUT PROCEOURE 149 
eee enn nna ee | JOB TYPE: 
{ 621TYI JOB/SESSION NUMBER 150 1 2 SESSION 
ee Od eeenrnees: ss wonnne-eennnn nee | 22 308 
63) RESOURCE COUNT 1 
G4] PROCESS ELAPSED CPU TINE (MSEC) SINCE LAST [52 
65] CHGROUP CONNAND. USED BY CI’S ONLY. (53 
al RESERVED FOR FUTURE USE [54 
67| , RESERVED FOR FUTURE USE [55 
70| ICY! st 56 
n TIMEOUT TRLX 8? 
72| {58 


| 808800860880 00 6 0808 OOO S2S8 CES OE BO AASTEEESSOHOTO® | 
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OSI State of the “USOFT” PCB bit when control-y 


trap was entered. USOFT = 1 allous user soft 
interrupts against the process. It is set to 
zero uhen the control-y handler is entered. 
It is set to its prior state when the user 
calls RESETCONTROL. 


® Set to connand record length when connand pending 
(i.e., connand entered during break or encountered 
during flushing). 


&& CONTINUE FLAG Values 
© = No CONTINUE in effect 
1 = CONTINUE just encountered 
2 = CONTINUE in effect for this connand 


CY FLAG 


PCBXFIXED(S6).(1:1) = Set by PSEUDOINT uhen there is a pending 
control-y which cannot be processed because 
of systen code or privileged code. ININ 
checks this bit on bounds violation or 
trace trap. 


ST FLAG 


PCBXFIXED(S6).(3:1) © Specifies the state of the user interrupt 
flag when the current control-y was processed. 


PRIV MODE BOUNDS FLAGS: 
BITS 0-1 = 0 if DB, Q and $ bounds checking is disabled 
= 1 if 08 bounds checking is disabled with Q and S bounds 
checking enabled 
# 2 if DB bounds checking is enabled with Q and S bounds 
checking disabled 
# 3 if 0B, Q and S bounds checking enabled 


IFNUN: File number fron intrinsic TRACE 
ERROR ON CNT: Wunber tine though error on 
Vv « V/Plus transaction trace (1#0N; Os0FF) 
E = Tracing Enable (12Enable; OsDisable) 
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PXFIXED Assignnents (Cont.) 


1117941 9°49 
0123456789012 34 5 
ee ee ed eee ed er oe Oo de Cd 
731 ‘ig 
4) PCLASSAASK i 
’5| —- PROCQUESTOPWORO er 
| nocennnneeennnnenennene cannon nneenererenneces 
76| {62 
PROCSTOPTINE | 
77| ve 
,; 100| PC CENTRAL TERMINATION DST (64 
101| IFNUR | ERROR ON CNT | V/E {65 
} 102] 166 
J- PROC PREEMPT TIRE | 
} 1031 \67 
| \68 
| PXFIXED EXPANSION BITRAP | 
{ 11 |79 
wus ee oo acee ee peweecanaeaeeasseseens | 
NOTES: P = 1 if opened by priv user 
$21 if data segnent is sharable 


PCLASSRASK »#® Bit nask of classes this process has enabled 
PROCQUESTOPHORD. (0:4) = PROCESS PRIORITY: 7 = L queve 
6 = C queve 
2 = 0 queue 
13 € queue 
. (4:12) = REASON STOPPED: 1 = stop seg fault 
2 * stop disc wait 
3 2 blocked I/0, non-terninal 
4 = terninal read 
§ = stop inpede 
6 = stop active 
PROCSTOPTINE = OBL word timestamp of uhen process stopped for 
reason given an PROCQUESTOPUCRD 


ocy A delayed Control-Y is pending (this bit 
is checked by ININ en bounds violation to 
deternine if it got: 1) true bounds violation 
or 2) an induced bounds violation that 
indicated that the Control-Y trap procedure 
nay now be entered). 
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PXFIXED Expansion Bitn 


The PXFIXED bitnap and expansion area is for use in accounting of extra 
data segnents acquired by the process. 


File Systen Section of PCBX (PXF 


The PKFILE area is a subsection of the PCBX. It is a conti » expandable 
and contractible block of storage that is nanaged by the file systen 
prinarily for ite oun use. Other subsystens, nanely CS and 0S, also nake 
use of the PXFILE section. In doing so they must conform to the 
conventions of the file systen. 


The overall structure of the PXFILE area is: 


| 
OVERHEROD ene 


OO S88 O8OO8G OOS SS288S 888 | 


| 

| 

| 

| 

| : 
| CONTROL BLOCK | (VARIRBLE) 
TABLE 

| 

| 

| 

| 


| 
AVAILABLE intr) 
ee : 
| ACTIVE FILE | (VARIABLE) 
| TRBLE ! 
| |OL-5 
|onnn--eeennennennnennon| 
6.23.00 
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Process Tables 


Overhead 


The part labeled Overhead contains naticn that pertains to the e section. It 
inforis addressed via the pointer at DL-3. 
entir 


1411 1 1°71 
1234567890123 4 
ma es pe ped pr eo bod od Od od ed eo 
O|  PXFILE SIZE IN WORDS 10 PXFSIZE 


| 
1] LAST OOPEN ERROR #@ | LAST COPEN ERROR # [1 


2IN | 2 

1 ust Osa ee aye F 

‘| Sue AFT ERS i 

s| LAST ROPEN ERROR w | LAST FOPEN ERROR WS 

él aT SDE IN UORDS ee | \6 PXAFTSIZE 
2 a Sie eee et tia ? 

CS TRACE FILE INFO ‘ (PXCTRINFO) 


| | 
ui LAST RESPONDING NO-WAIT 1/0 AFT ENTRY @ : PXF LEF TOFF 
12| tST USER (NOBUF) CONTROL BLOCK TABLE DST ® 110 PXFCBT! 


SS 29S OOOS046 GOSS SSSSSSHDOSESEESES PPPS ODDOSDE BOOS8OESBO 


13]  2NO USER (NOBUF) CONTROL BLOCK TABLE OST # |11 (PXFCBT2) 


14]  3RD USER (NOBUF) CONTROL BLOCK TABLE OST W 12 (PXFCBT3) 


15] 4TH USER (NOBUF) CONTROL BLOCK TABLE OST # (13 (PXFCBT4) 


STH USER (NOBUF) CONTROL BLOCK TABLE OST #@ |14 (PXFCBTS) 


~ 
°o 


| 

— Stedaacacccsccacusonscuwae jecuancvesem as 
me 6TH USER (NOBUF) CONTROL BLOCK TABLE OST # i“ (PXFCBT6) 
7TH USER (NOBUF) CONTROL BLOCK TABLE OST # 116 (PXFCBT7) 
ST 8TH USER (NOSUF) CONTROL BLOCK TABLE OST # 117 (PXFCSTS) 





Partial word field identifiers are: 


PRFDOPEN s PXFILE(1).(0:8)8, last DOPEN error code 
PRFCOPEN = PXFILE(1).(8:8)8, last COPEN error code 
PXFNOCE = PXFILE(2).(0:1)%, no CBs in PXFILE CBT? 
PXFKOPEN = PXFILE(S).(0:8)#, last KOPEN error code 
PXFFOPEN = PXFILE(S).(8:8)@, last FOPEN error code 
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PXF n kT PXF CBT 


Addressing within a PXFILE control block table is soneuhat more complicated 
than addressing an extra data segnent CBT since the table does not begin at 
0B+O. As a result all pointers within the table are table relative; the 
starting address of the table must be added to a pointer to generate 2 final 
08-relative address. This addressing convention is consistently applied to 
all control block tables. 


When the control block table is expanded, space is taken fron the AVAILABLE 
area. If no space is available then the PXFILE area ie expanded and the 
acquired space is added to the AVAILABLE area. 


Bvailable Block 


The part labeled Available is used to provide space uhen the Control Block 
Table er the RAetive File Table is expanded. These tuo tables grou touards 
each other, and when more space ie needed it is sinply taken fron the 
Available Block. 


When the Available area is exhausted, the PXFILE area is expanded, the AFT is 
relocated and the new space is added to the Available Block. 


Currently the PXFILE area is only expanded; it is never contracted. For nore 
information refer to Chapter 6, “File Systen”, and see the Active File Table. 
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Process Tables 


Discussion: 


PXFAFTSIZE This is the size (in uords) of the Active File Table (AFT). 
The size is in words to sinplify calculating the size of 
the available block. 


PXFCBT1-8 These are the OST nunbers of the user (NOBUF) control block 
tables. fA OST nunber of O indicates that no data segnent 
is allocated. 


PXFCOPEN This contains the last COPEN error number. Wot used by the 
file systen. 


PXFCTRINFO This contains infornation pertinent to the CS trace file. 
Not used by the file systen. 


PXFOOPEN This contains the last OOPEN error nunber. Not used by the 
file systen. 


PXFOSINFO Reserved for DS. Not used by the file systen. 


PXFFOPEN Thies contains the last FOPEN error nunder. If it is zero 
then the last FOPEN successfully completed; otherwise the 
last FOPEN was unsuccessful and the nunber is the file 
systen error nunbder. 


PXFKOPEN This contains the last KOPEN error nunber. KSAN 18 partly 
enbedded in the file systen, and an FOPEN failure on a KSAM 
file can be caused by a failure to open eather the key file 
or the data file. This error nunbder is used in conjunction 
with PXFFOPEN to deternine which file caused the KSAN open 
failure. This error nunber is not used by the file systen. 


PXF LEFTOFF This is the AFT entry nunber of the last file/line that 
conpleted a nowait 1/0; if zero then no nowaat 1/0 has been 
conpleted. This cell is maintained solely by and for the 
IOWAIT intrinsic. 


PXFNOCB This bit signifies that control blocks are not to be 
created in the PXFILE control block table. This bit is set 
by the NOCB paraneter to the CREATE intrinsic or the :RUN 
connand. This feature pernits the user to have as much 
stack space as possible; otherwise the file systen uill 
take several hundred uords of stack for the PXFILE control 
block table. 


PXFSIZE This is the size (in words) of the complete PXFILE area. 
It is the sun of the overhead block, the control block 
table, the active file table and the available block. 
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Process Taoles 
PCBX For Core Resident Systen P 9 Stack 


0123 4 5 6 7 8 8 10 11 12 13 14 15 
es ey ped nd bes ped ps pe od tee po oe 
0] DISP FROM PCBX TO OL 





\ 
| 
" OISP FRON PCBX TO 08 i1 | 
2] USER ATTRIBUTES (ALUAYS -1) 2 | 
3] 0 13 | 
[ooo ccsereaiacee ect ee eee el | 5 PNCLOE 
4| 0 ja | 
see cae mannencenennenrnne |_| 
\s 
|eececene|-n|=-|-cececsenoeneeenennenncnenenenen| 
6| o | 01 11 0 \6 
nacennen fen |en|ren-aonmmnenmenannseneenenecnene| 
a 
10 ACTUAL JOB INPUT LDEV 1 | 
11] ACTUAL JOB OUTPUT LOEY 3 | 
1210 0 | 
13 0 I / 
12] PXFIXED SIZE (e-b) H0\, 
13] «RELATIVE $ (S-08) I | 
v RELATIVE Z (2-08) 2 | 
15} INITIAL @ (Q-08) 13 | 
16] RELATIVE DL (08-DL) 4 PNFIXED 
17] GENERAL RESOURCE CAPABILITY (-1) Is | 
20 RESERVED 6 | 
21{ 0 417 | 
[asus coveobedendosanaateiscebboccatenncenstccte 1 | 
2 Cle Ie | 
2 OL-b 9 | 
26] Dl-a 120 / 


wOTES: 1. “here as ro PXFILE area. 
2. The °“FIME: area is -uch smaller than 3 nornal PCSX 
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Process Tables 


Process To Process Connunication Table 


This table is used as the connunication link by uhich father and son 
processes conmunicate with one another via the mailbox schene. This table 
contains tuo words per entry and 18 indexed by PCBM (entry index O is 
neaningless). Each tuo word entry of index N essentially relates uhere, as 
well as how much, nail nay be found for a process N with respect to 
communications between N and his father process. 


Entry Fornat 


298 C6 88222882866 OBO H AHORA 


word O| 


word 1 


Uhere word 0 2 the # of mail words to 

be transferred. 
word 1 2 the only word of nail 
iteelf if word 0 2 | 
otheruise 

it contains the DST# of 
the extra data segnent 
uhere “word count" words 
of mail exist. 


NOTE: Assune procese S$ is the son of process F. Then the process to process 
connunication table index which will be used for mailbox connunication 
betueen son S$ and father F will be that of the son (i.e., $). 
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FORTRAN ical Unit Table (FLUT 


The segnenter is responsible for the preparation and initialization of a 
FORTRAN logical unit table. This is done when a progran is prepared if that 
progran contains at least one progran unit that references a logical unit. 
The location of the FLUT 18 in the secondary OB area and the address of this 
lecation is contained in DB-1. 


The FLUT is fornatted as per the following exanple: 


|------- 
bB-1| x | 
|-n--en- 
a Po 
DB+K| 3 | 0 | 
1410] 
|---|---| 
$540 | 
|---|---| 
17101 
|---|---[ 
110 1 0 | 
|---|---| 
j255| | 
I---I-2-] 
| eon non nnn nnnonnn-\ 


| 

2nd BYTE 
The fIPE file nunber (as returned 
by FOPEN) used in accessing the 
file. Zero if File not open. 
Filled in by formatter as each 
logical unit is initially 
referenced. 


1st BYTE 
List of the logical unit nunbers 
referred to in this FC&TRAN- 
produced progran. 
(255 terninates). 
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Process Tables 


ubsysten Reserved Are 


08-12| RESERVED FOR SORT / RERGE 108-10 
be-t1| RESERVED FOR TRACE, TOOLWOX, == i08-9 
| AND BUSINESS BASIC | 
bb-10| EXTERNAL PLABEL OF OUTER BLOCK i0a-8 
08-7| RESERVED FOR TRACE AND SYMBOLIC DEBUG {08-7 
De-6} OB ADDRESS OF STL tS 108-6 
be-s| RESERVED FOR COBOL =SSSSCSC~C~S {08-5 
pe-| RESERVED FOR COBOL 18-4 
bb-3| RESERVED FORCOBL 108-3 
be-2| RESERVED FOR FORMATTER AND PASCAL iB-2 
bet} OB ADORESS OF FT ttt~*” iB-1 
ee | 
. DB AREA . 
|-eeoneeeenenceveennwneeseneesecnnesstsenenee | 
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Job Tatles 
HAPTER TA 


ob Tabl vervieu 


Contains infornation 
Entry is created at the introduction 


Job Master Table (JNAT): One entry per job/session. 
needed to get the job/session running. 
of jcb/session. 


Job Information Table (JIT): One OST per job/sessicn. 
needed by the job/session as it is executing. 


Contains information 


Process Job Cross Reference Table (PJXREF): One OST per systen. Used to 
deternine the job/session nain process (Connand Interpreter) for any process 
cn the systen. 


Job Procese Count Table (JPCNT): One entry per job/session. 
used to index into the JIR to lock job resources. 


Job Directory Table (JOT): One OST per job/session. Contains the following 
gub-tables used by descendants of job/session. Must obtain JIR (by using 
JPCNT index) before accessing JOT. Sub-tables: 


Entry nunber 


1. Data Segnent Directory - Directory of sharable OSTs used by job/session 
2. Tenporary File Directory 

3. File Equation Table 

4. Line Equation Table 

§. Job Control Word Table 


Job Cut-off Table (JCUT): Stores total CPU tine limit of job/sessicn and 
accunulates the CPU tine that job/seseion uses. 


UCOP Request Queue: 
terminating. 


A queue of Process Identification Numbers that are 
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Jeb Tables 


e Tab 


SIR = 15 2 217 
DST = 25 = 231 


| 
| 
| woe | conn omnes onnennoncoooccnce at the tail of the WAITing List. 
| SI “Ty| SCOUNTER {S Next assignable session #, TY=1 
| wow | enemon cen enwennsncewceeccee| Words 687 are a double for 
)} 6] NOT USED [6 PE X/L conpatibility. Only 
| | enw | eee nnenewnencnennncocenncee| the LSU is used in MPE V/E. 
! ut a JCOUNTER : Next assignable batch @#, TYs2 
} 10] NOT USED \8 
| |= Jone ]-|-|----- | --nee ne] ooo noe | L=1, logoff in progress 
| 41LISECISIII |SFENCE |JOBFNCE|9 S/Js1: S/J # dup check arned 
| Jo fone|-]-|erene [ennnene | ooeeeee| SEC=O, high; #3, low JOBSECURITY 
12| SLINIT {10 wmaxinun nunber sessions C : 
13] SNUA {11 current nunber sessions , : 
14 SLIAIT {12 maxinun @ batch jobs ' E ; 
nenawccwccoenaeouscccosonconaesce N 
15| JNUT (13 current @ batch jobs I r . 
j 16] JMAT SCHEOHERD 114 DB pointer to head of Y6 
| | penance een none nnn nen en noe nnnen=| scheduled job queue 
6.23.00 
8- 2 
Job Tables 
Job_ Master Tabl ntry 
1941179191 
01234856789012345 
I-l-belel-t-t-l-f-1-1-l-l-1-1-1-1 
01 STATE [DITIGIAUIC| Lead {0 state 
woe] ewowee-|-{-|-|-|-|-|-------| O = free entry 
a] Ty JOB/SESSION NUMBER \1 1 = introduced, in 
a nd | STARTOEVICE 
| 2 NOT USED 12 270 = scheduled in scheduled 
wowwewonconeeneosccccccoonwcene job queue 
3] 13 2402 waiting jeb in 
4| USER KANE 14 scheduling queue 
5| 15 260 = initial, UCOP 
6] 16 has created JSfP 
| enecennnnenenenneecen nnn neeeen=| 2 = executing, JSMP 
7| {7 firished initial. 
10] RECOUNT NANE is 3s terninating. 
11] \9 4 = suspended. 
12] {10 0 = duplacative 
| eon weeweeeween eran ne= ccoeceenn=| : = interactive 
14 ae passuord 
14] JOB NARE \12 faut T node, if state = 2) 
15] (13 A = account passuord 
16| 114 U = user password 
| poeneenccecncconcesoccence onne| 0 = passuord validated 
17 15 (STARTDEVICE) 
20| GROUP LOGON NRNE 116 1 -® must validate passuord 
21 117 (INITISHP) 
22] 18 R= reserved 
| eoewew cere se wnnmnernoserococoe= | C = JLIST is device 
at JIN DEVICE ta class index 
24] JUST DEVICE. {20 
25) JULIAN CATE (CALENDAR) 121 
ewwwcenccenrenensenecsorscooce= ty = 1 - session 
26 TINE (CLOCK) (22 2 - job 
27| ' te 
| ae LANGURSE =| KPRI _ 
31] MAIN PIN 125 
321 ee pa 126 0 default, -1 * no limt 
«|-|-|oo- | ------- | -------------| 
33/S|RINIFT JOUTPRI | MUNCOPIcS [27  ORIGJIN/ORIGILIST is 
o]-|-]--- | ------- | --- nen nnee used as a scheduling 
| ORIGJIN 128 link by UCOP uhen states 
Joooees Snwwesacwenenes cosesoaere ] 240 or 270. G38 “cla*ive ptr. 
| 35] ORIGILIST 129. —s Lest entry in List contains 
| Pere ree wen www mn nee nnn ne rnnnnnn- i zero (0). 
6.23.00 
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012345678 91012345 
| 


=} fet=l-}tede dele le d-tebet- \- 
0| XSIZE CURSIZE {0 
1| VAGUNT | ENTRY \1 
| INFO | Size | 
| SOSos eee Seaeseeeeaneneounen 
Z| ENTRY POINTER {2 


| 
3| WAITING QUEUE HEAD POINTER [3 


| 
4] WAITING QUEUE TAIL POTHIER 14 





nay ructu 


aah 0 


| 

| 

v 
nax JART size (uords/128) 
current JAAT size (uords/128) 
sVNOUNT state saved for 
WARMSTRRTs; JMAT entry 
size (246) 
08 pointer to first entry (246) 


0B-relative pointer to entry 


at the head of the WAITing list. 


OB-relative pointer to entry 


Job Tables 


b Master Tab AAT) Struct n 
|-------- wncnnnnnncnnnennnennee a 
17| WORKRREA j15 SFENCE is session fence 
| (23 WORDS) | 
20] 116 0 J 
+ : (ENTRY 0) 
4S] na v 
| conn enn wenn n nnn neeeenn seman eee ire 
46| 138 * 
| | | 
| | | (ENTRY 1) 
\ ed 
| | | 
| ! (ENTRY 1) 
| 
113} 175 v 
aan , 
| | | 
| ! | (LAST ENTRY} 
| | | 
| | v 
|---ennneccennnennnneneennnnnenee — 
SCHEDULING QUEVE 
WAITING SESSIONS 
FIFO within HIPRI/INPUT priority 
ERROR JOBS 
FIFO 
WAITING JO8S 
FIFO within HIPRI/INPUT priority 
sie 0 
-3 
Job Tables 
fi r_Tab nA n n 


| 
36| JNAT CREATOR PIN 





[30 
|-|-|-|--------=- | 
aia i hi 
bi DATE OF LAST CKGROUP ts 
| TIME OF LAST CHGROUP ie 
42| Is 
43| RESERVED haa 
“4| UNUSED ie 
45] UNUSED \37 
batelstolefetelatedelelolotstatel 

§6789012345 
1499191 
R = RESTART 


Used with the progrannatic 
creation of sessions/scheduled 
jobs. 
® Progrannatic logon 
W = WAITTILLON 
N = NOURIT 


FT ® funny terminal 


WN = SEQUENCED 
$ = ORIGJIN is spooled. 


00 - regular tern. 

01 - ey ey 
special legen 

10 - RPL tern. 

11 - RPL tern. 
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Job Tables 


Job States 


JOB STATES - JMAT ENTRY WORD 0. (0:6) 


SHOWOB8 - Displays job states by scanning JHAT OST (231) 


LOGON uses all states except “SUSPEND” 


228 00848 06 BOO SEQ Q228 2220 00e" 


Job Tables 


Proc b Cross Reference Tab PIXREF 


OST = Z62 
TRBLESIZE © # PCB entries « 1 


2 45 67 8 91011 12 13 14 15 
Pye eels ee lei ie 
o| NUMBER OF ENTRIES ] 
| © (caw ocean cece ewe aes cee ewe weaceecwonoroeneneweoce 
1] J/S NUMBER OF PIN 1 





” TVPICAL ENTRY 
Seta eee anne ep 
| JCUTCPUL 


NAXIMUN 64 WORDS LOXG =~ > TIME LIMIT 
(SECONDS) 


j 
| 
I | 
1 | 
[ > TIME COUNT 
| /  (ASEC) 


| 
| STATE | PROCESS | SEGHENT | PROCEDURE(S) | | 
STATE | STATE | PROCESS | SEGMENT {| PROCEDURE(S) «(itd ete ete eee error ener cre resenenneeeeeneeecennenene 
| NO. | NAME = | | | | J/S NUMBER OF PIN 2 | 
|------- |--------- |-n------- |--------- |----------=--- onnecennnenn== |ececeeeeenennrencenenennnncnnenn en nnnnnnnenane> | 
} 1% | INTRO [ OEVREC | NURSERY | STRRTDEVICE - PUTJMAT | : i 
| | | Jsnp | | = ALLOCENTRY IN SEGHENT | 
| | | SPOOLER | | ALLOCUTIL |  [acattaechatatetetetetatetetatedetataatahetatatatatanetatatstateteteteteheteteteneetatate | 
|---n--e |eeen--n-- | ---eeeee- |-n-ee--n- | eenewcwcen crew ccncceccencen- | n| J/S NUMBER OF PIN A | 
| 270 SCHED | UCOP JJOBSCKED | CXSTSTRERM | | cocnw nce ccwsenccwnnesererencenesetewseresenane | 
| } | | | SCHEDULEOSCKED | n+ " J/S NUMBER OF PIN A + 1 | 
[=2=5=<- [Sess aett aces aeeans |eaeseeeon | oasaseseatecnesasesseweseeset . 02202606060 lt SRR R RR Ramen R ese he msseanserentie rater tee 
| 240 =| -~WAIT | DEVREC | NURSERY | STARTDEVICE - SCHEOULEJOB | 
| | | JSAP I\ | | This table is only used by the SHOWQ connand. The entries in the table are 
| | | acai SPOOLSTUFFIN ->SCKEDULEJOB | set up through PROCREATE and modified by MORGUE. 
| | | SPOOLER | | 
| ------- | o-o-eenne | -----n--- |ornnneoee | eonowesseeee ee enenwencswcese | The job/session nunber is in the fornat: 
| 260 | INIT- | UCOP | ucoP | LAUNCKIOS | 
| | IALIZAT-| | { | 
{ | ION | { { | 01234 5 6 7 8 9 10 11 12 13 14 15 
|------- |ocereeee- [or-eeee= |eceresenn  batutatatetaeieduieetabenamanenpeeneneieranataneate | [-oren- | sometaeeasnereanasnses-ceseseases-ssse5= | 00 2 Unused/undef ined 
} 2 | Exec | JSNP = | NURSERY | INITISHP | | | | 01 © Session 
|------- |-n------- |--------- |-n------- | -----nennononn--nnnnnnnnnn=- | | ----o-|--------n-nnn-none-neneennnnnnenennnneene | 10 = Job . 
| 3. | TERNIN- | JSnP | MORGUE | TERMINATE - EXPIRE - | 11 © Unused/undefined 
| | ATING | | | CLEANUP J08 } Bit 2-15 = Jod/Session Nunber 
|------- |--------- |---eo---=|--------- | -------2nnnonnnnnonneennnno- 
{ ©O | FREE | JSP { MORGUE | TERMINATE - EXPIRE - | A conpletely zero entry is either fron a systen process or a currently unused 
| | ENTRY | | | CLEANUPJOB - DEALLOCENTRY | pin. 
| ! IN ALLOCUTIL | 
4 | SUSP JSP | OPLOW ! CXBREAKIJOB 
For estates INTRO and WAIT, 
DEVREC = logon connand originated on terminal or 
other unspeoled device. 
SPOOLER = logon conmand originated on spooled device. 
JSP =. _ logon connand is the result of the execution of 
a :STREAM command. (This also includes USER 
processes which have done progrannatic :STREANs. ) 
6.23.00 6.23.00 
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Job Tables Job Tables 
Job Process Count Table (JPN) igh Cutoff Table (JCuT) 
1 Bat Entry / Running Job 1 Entry / CPU-linated Job 
MEMORY RESIDENT MEMORY RESIDENT 
SYSGLOB a s rete SYSGLOB BASE = 08+11(213) 
| OST = 24 (230) DST=36 (Z44);SIR214 (216) 
| SIR ® 8 3 (215) SYSGLOB + 2117 = default 
17991 CPU tine limit for jobs 
0123456789012345 
(-f~-{-1-1-1-1-1- I-1-1-1-1-l-l-1- 123 4 5 6 7 8 9 10 11 12 13 14 15 
O} TOTAL CONFIGURED NUMBER OF | |--|--]--]--|--|--]--|--]--|--]--}--J--|--}--l--]\ 
| JOBS AND SESSIONS nee | # OF REAL ENTRIES | 
1] TOTAL NUMBER OF FREE | | ENTRY SIZE (3) he | 
| ENTRIES | | ewerecenceeerenne wen nnrn nore nen nen ewer nena nn o= | | HEADER 
| none nnnnereercnweccnceennenncen| [-e--| FREE HEAD |2 > ENTRIES 
2] BIT AAP RELATIVE INDEX OF fo | fw rm mmr come eeemmenonne em enwesnrowonececose-- i | (2) 
| WORD CONTAINING NEXT | /--| POINTER TO LAST ENTRY (0) 13 | 
| FREE ENTRY | weewerenmenwnwose ene nn enn cc ceeeceeeeneceencene-| | 
| eewecen en nnenneeneronescencne --| | UNUSED 4 | 
3] UNUSED rs Cs 1 Oe Coot) D8 1 | 
| | | UNUSED is | 
| --------n----=-----nnnnnn--=-o=| [-neencwcenennnennnnmnnn nnn nnn nnnnennmncennnne | J 
4| | free entry = 1 > 
| | allecated entry *0 
| BIT RAP | = 
| 
| 


| 

| JCUTCPUC 
A JPCNT entry must be allocated before the nain process can be precreated. 
The JPCNT Index 1s located in word 4, PXGLOBAL area, of the stack of a job or 
session. One JPCNT Index is allocated per job or session. 


The job SIR (JIR) = base + JPCNT index, where base is the nunber of syeten 
reserved SIRs. The JIR is used to lock the Job Directory Table. 

NCTE: This table is conpletely bit oriented with each entry consisting of 
one bit. Entries are taken fron available pool on a "first found" 
basis. A "1" found in the bit nap indicates a free entry. A zero (0) 
found in the bit nap indicates an allocated entry. Word 2 of this 
tacle 18 the index of the word in the Bit Map where the next free 
entry resides. At systen start up, this word is set to zero (0). The 
Bit Aaa aa be thought of as ranging fron 0-63 (64 total words - 1024 
entries). 


OF A EE SS AS SS SS AS AS SS SD SY SND ND CD SD ce 


| 
=> POINTER 10 NEXT FREE ENTRY | 
| (END OF LIST = 0) | 


FREE ENTRY 


ee eg cee ee og” 





rd | | 
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Job Tables 
b Information Table (JIT 
JIT OST 1s nord 11 base in PXGLOB 
1411911 
0123456789012345 
en ae 
0] JIT 0 a 10 
1] 6 | NOT USED }1 
| 2{ POINTER TO JOB INFO (Z7)* [2 * May be X10 for Systen Processes 
| awnennnn-norencnnnnnenneneeern= 
i 3 POINTER TO ACCT INFO (260) 13 
| pecennnnnnonennenenesenennnenes 
| 5 POINTER TO RESERVED (273) ‘* 
[oowcerewscownrsocecccoosorsrcwe | 
ASSOCIATION TABLE INDEX : 
6] |FI6 =F = Job/Session-wide 
[ees|eeres aCasessenres= enacse|=| FPMAP option Flag 
un | 308 NUNBER : (ISFPRAP) 
10| |8 TY - 1 ® Session 
ee ara td | 2 = Job 
11] | 7 : 
12] JITNAXP ler {10  JITMHAXP - MAXJOBPRI capability 
| seneeasseseeoss lana |=eHee=s<e85 | JITHPN = Job main PIN. 
} 13] JITHPN 111 JITEOF - used by FCLOSE to tell 
| _ [ceewereenceescncoce cocccenecees| CI that a SSTDIN/X file uas 
| 14] dS DATRSEG (12 closed u/out =a at Bk 
| [ewe weewwe coc occwcernnnwecerccce EOF. (8:1)sSSTOIN, (9:1)s6STOINX 
a JITASEC ne JITASEC = Recount Security 
16] JITGSEC (2 uOROS) |14 
| GROUP SECURITY ! 
201 JITHAN (4 WORDS) 116 
| ACCOUNT NANE 
24] JITHGN (4 WORDS) 120 
| HORE GROUP | 
K+} JITLGN Sy uoROs) j24 
| LOGO | 
lolol tolletelefolete foto [l- 
0123456789012345 
1711111 
G. 23.00 
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Job Tables 
nfornation Tab Cont 
119191 
890123 a 


eetededettelelelelel-te t 
60| 3 (48 Recounting Infornation 


61| JITCREC - # OF CREATIONS 49 


62| JITCPUC 19 
oT cPu lade A 
“| WOT USED | HIPRI ‘i HIPRI - highest job priority 
65| 0 153 Recount 
et JITAIP id Index Pointer 
67| 0 {SS Group Index Pointer 
70| Ba “= Systen Volune Set 
1 7 0 | PVTABX [57 MVTRBX - fteunted Volune 
| __ freeceerseenecee ]ooeceneenneseee | Table Index 
| 72] JITGIP \S8 Group Index Pointer 
| |receeneemneenennencemeresoncnoe | Mounted Private Volune Set 
73| 1 {59 
ee 0 ie 
75] 161 
76| ALLOW MASK 4% {62 
77| 163 
100] \64 
He 165 
02| 166 
ple 9 alba 
$9012345 
111179141 


* The fornat for LAP (246-47) is as follouss 


J Of af 2 31 44S) GL 7h Bf 9]1ol11 [12193114115] 


WORD1 [SNJAR[ALIGLIOIIGPICVILVILG] |PS{NA|KN/CS{ND| SFI 


vorp2| ' [pr{zalen| = {NR} [OSTPHI 
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rere : ieee 
eat 


&% The Allow nask for IPE V ie expanded to six uords. There is a mask in 


Job Tables 


b Information Table T ont. 


111111 
01234 89012345 
eeetlsttitelelet-le-lett 
x4| [28 
35| JITUN \29 
36| USER NARE |30 
37| 131 


| 
40| POINTER TO JLTAIP (265) is 


[-t-| 
ia POINTER TO JITGIP (Z67) ji P - Group's hone volune is 


| eooc we emn we cenneneswonecece a private volune 
42] LATTR {34 A - Pravate volune mounted 
43| LOCAL ATTRIBUTES 135 (1.e., group bound to hone 
| pone n enn necenennenosesene eon onn | volune set), JITGIP = 271 
44| PASSF 136 
I PASSED FILE POINTER |37 
ast uCAP |38 
a USER CAPABILITY * hig 
50| RESERVED FOR OS'ITI |40 
51| JITCPUCCHGROUP 141 
ee ns used since last CHGROUP |42 
$3] LOCAL RIN POINTER e 
54| (44 
55| JITIN {45 
56| JOB NRNE - 


§7| 
eee esa 6 
23486789012345 
119991 
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Job Tables 


Allow Mask Fornat 


each user’s JIT and the global allew mask in the SYSGLOB extension area. 
The Allow nask contains enough bits for a cne-to-cne correspondence to 
every present OPERATOR type connand, or any future OPERATOR connand. When 
a user is ALLOMed any OPERATOR connand or ASSOCIATE to a device (which 
will use OPERATOR tape connands) then the corresponding bit(s) in the nask 
an that user’s JIT for that connand is set. If the ALLOW or ASSOCIATE was 
done on 2 global scale, then the bit(s) in the mack of the SYSGLOB area 
is/are updated. 


The following EQUATES define the nask bit for each cperator connand. 


The first set of connands define the operator connands dealing with 
devices. 


hen adding a neu connand to this set of EQUATEs, be sure to edd a 
corresponding move statenent in LOGINAGE, even if the connand will not be 


legged. 





Word Bit 

RBORTIO 0 60 0 
ACCEPT 0 1 1 
DOUN 0 2 2 
GIVE 0 3. 3 
HEADOFF 0 4 4 
HEROON 0 § § 
REFUSE 0 6 66 
REPLY 0 7 ©? 
STARTSPOOL 0 8 68 
TRKE 0 96CO 
0 10 10 

APLINE 0 111 
OSCONTROL 0 12 12 
UPPER LINIT -> OEVICE COMMANDS 
ABORTIOS 0 13° (13 
ALLOW 0 14 14 
| ALTSPOOLFILE 0 1§ 15 
ALTJOB 1 0 16 
BREAKIOB 1 1 17 
| DOELETESPOOLFILE 1 2 «18 
DISALLOW 1 3. 19 
JOBFENCE 1 4 24 
LIMIT 1 5 21 
STOPSPOOL 1 6 2 
SUSPENDSPCOL 1 ? 23 
OUTFENCE 1 8 24 
RECALL 1 9 2 
6.23.00 
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Job Tables 
Mord = git 
RESUAEJOS 1 10 26 
RESUNESPOOL 1 11 27 
STREANS 1 12 28 
CONSOLE 1 13 29 
WARN 1 14 Xd 
WELCONE 1 1§ 31 
FON 2 0 32 
MOFF 2 1 33 
VMOUNT 2 2 # 
UIDUNT 2 3 35 
LOISNOUNT 2 4 3% 
ARJECONTROL 2 § 37 
JOBSECURITY 2 6 38 
DOWNLOAD 2 ? 39 
MIOENABLE 2 8 4 
MNIOOISABLE 2 9 (41 
LOG 2 10 42 
FOREIGN 2 W 43 
| IMFCONTROL 2 12 44 
SHOWCON 2 13 45 
OPENQ 2 14 46 
SHUTQ 2 1§ 47 
| DISCRPS 3 0 48 
6.23.00 
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Job Tables 
) nen t n JOT 


If a OST is allocated as sharable, then it will have entries in both the JOT 
and PXFIX. Sharable neane that it can be be shared by all processes in the 
Connand Interpreter process tree (sons, etc.). Nonsharable DSTs only have 
entries in the PXFIXED. 


345 6 7 8 9 10 11 12 13 14 15 


|a=}-=1-=|-=|==[==]==1==]=-f--1--1-e f= 1-1-1 | 


| SEGHENT 10 : 
| EXTRA pata SEGHENT OST INDEX | 
| # OF PROCESSES ACCESSING | 


NOTE: A return of 22004 in the INDEX value after pa | the GETOSEG 
intrinsic indicates that there is no more roon in the Job Directory 
Table for another job sharable data segnent. 


Tenporary Fi nt n_ JOT 


§ 6 7 8 9 10 11 12 13 14 15 
| ENTRY SIZE | ANE SIZE | 
| (WORDS) | (WORDS) | 








ee | eseeeaoeeoue: 





WANE - ACTUAL FILE DESIGNATOR <ormmoNane may consist 
- of up to 4 subnanes 
| eenenenewce ncn cccew eens | eoweneneweecccosecorwo=| (File. Group. Account: 
VOLUNE POINTER | ENVID) 

FILE LABEL POINTER | 


Since all son processes of a CI share the sane JOT, exclusive access of the 
JOT is controlled wath the Job SIR (JIR) and is locked and unlocked by calls 
to LOCKJIR and UNLOCKJIR. The JIR nunber is found in the PXGLOBAL area 
(JPCOUNT index). Only job and sessions traces have JIRe, systen processes do 
not, even though they have JOTs. The JOTs were provided for systen processes 
for consistency, but are not meant to be increased or reduced. 


6.23.00 
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Fi 


Job Directory Table (JOT 


| 
O| MAX SEGNENT SIZE (WORDS)| 1 entry 


| 
1} POINTER TO JOSD | 


; POINTER TO JTFOD | 
e agararerae ee aaa 
ee | 
eu 
i prwTen To FREE space 


WORK RREA = 
[ 45 WOROS * 


: JSMPIN | 
s JOS DATA SEGHENT 
JOSO” DIRECTORY . 


| 
JOB TEMPORARY FILE ~ 


Job Tables 


per job 


OST W in word 10 
(base 10) of PXGLOB 


JTFO DIRECTORY | ENTRY | = NARE | 
i j | SIZE (WOS)| SIZE (WDS)| 
| eroco no nmnn nn nneeoennnoene 1 C1 | C2 | 
| | [eeenecnenne|occnnenene>| 
a JOB FILE EQUATION J eeennnnnnnn|oennee--e-- 
JFEQ LE . ! CN | (24) | 
[scennccennenneennnonnneene 1 | | 
JOB LINE EQUATION | TRY | 
JLET” “| INFORMATION = | 
|--nn-eeennennnnenmenncnees 1 | | 
| | [eeeeeecennnecenennnnne| 
oi JO8 CONTROL WORD 
7 TABLE ” The nane is a concatenation of 
| woe nnn nn enn ene nwewnnnnnoce | up to three subnanes. Bit 0 of 
| { the 1st character of each 
FREE SPACE subnane is 1. 
6.23.00 
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Job Tables 
uation Table Ent n JOT 
4 6 7 8 9 10 11 12 13 14 1§ 
[le foekeebesleesle-lo=I- Fee pe od | 
| ENTRY SIZE | | 
| (WORDS) ! me inns) ! 
= WANE - (FORMAL DESIGNATOR) ' 
| PASK | 
\2 
| | : 
| NANE LENGTH | DEVICE LENGTH | 
| (BYTES) | (BYTES) | 
|---n--------ecnenennnnn | -nennnnnenenneeennennee| 
NAME-ACTUAL DESIGNATOR 
; (nay not be present) ' 
DEVICE/CLASS NANE 
; (nay not be present) i 
| FOPTIONS " 
| AOPTIONS je] {* 
Setsewen st aasendeessen= | escseesseeesss| ==> |--| 
{ WBUFFERS | IWIT ALLOC [D |¥ |S |<---DISPOSITION: 
ene ceco cn en nen ere cc cone | eonereoeesseee | o-|--|--| BIT13 DEL 
| RECORD SIZE | BIT14 TENP 
mecwcnencesons | ennncnne | eo ncewccccooeccccooecoe | GIT15 SAVE 
| @ EXTENTS | | BLOCK FACTOR | 
| FILE 
ht OP TE OE Es BE AEs ie A A SS ON A SS EG TS SE ah a le A A NT a GE DT EO EP MD RR: BE SR woo~|} 
| SIZE | 
ge Ue £e oe ceca ele soe bubeuse taenause --| 
{ FILE CODE | 
buudese soealacoses Sense beswedal veseece senses | 
} OQUTPRI | NUNCOPIES | { 
| REF COUNT | # OF USER LABELS | 
esaet team scewsouus lal eok ae seudeebewe nn caseces i 
| LENGURGE (NATIVE LANGUAGE SUPPORT) | 
omen ew ennenenennaense neennneacennnennnannannns| 
| LENGTH FORNS = / LABEL = | 
[Steer sets snc seen roster aseeeseesseseccesssse= | 
1 FORMS / LABEL =—ARRAY | 
| -----n2n-nnn2--222---n2nnneweneneennennnen none] 
6.23.00 
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Jeb Tables 
b Line Equation En 
|---neeennnennnnneecnnn-=|-neccareeannncceocorene| 
| ENTRY SIZE | DESIG. SIZE | 
(WORDS) | (WORDS) 
= FORMAL LINE CESIGNATOR = 
id (1-4 WORDS) ; 
| nenennnnnnnnn nnn nnnnneenenee econ nncnnecccercooe 
0] PRASK! : 
{| REF CNT | Pt PRASK2 |? PsFLAG 
| 28000000 008280288 S88888E92 j COSZO | OC SZe ES A Se ae A GE 
2] NAME LENGTH DEV LENGTH : 
| OSS 6 OOS OOS CFOS BOSHSBOESES | CBSO OESO® > > aD E> GP aD ab oD a rae 
_ (3 
: NANE 6 
| ( END OF LEQ ENTRY IF NON-BLANK ) : 
6| 16 
| coconnn enna co ncowecconccesccns esassecs ennneccce | 
7| |? 
| | 
10] \8 
| DEVICE | 
11| \9 
| | 
ia hag 
be PRASK3 ha 
14 DRIVER NAKE | \12 
| LENGTH | | 
| ----nannnwnnnennnnncean|-nnnncnnanenenennconeee| 
ss Ne 
16] j14 
| ORIVER WARE | 
17] 115 
| | 
et us 
LIST PNTR je 
a COPTIONS ue 
23 ROPTIONS ie 
24| DOPTIONS ig 
6.23.00 
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Job Tables 
Aspti and Fopti k 
OPTION WORD 2 OPTION WORD 1 
(ROPTICNS) (FOPTIGNS) 
Ol---| O|---} 
| 0 | }o} 
i | en | 
{o| }o | 
| [---| 
{of} 2; 
|---| {| |FILE TYPE 
jain 
ot Hei | 0 
si | 5{ 0 JOTSALLOW FILES 
| RULTTI- |---| 
6| {ACCESS 6| {LABELED TRE 
|--- |---| CARRIRGE 
a faa BUFF. ys ee 
8) | | | 
{| JEXCLUSIVE | [RECORD FORKAT 
= = 
10|  JOYNAMIC LOCKING 10] = | 
|---]MULTI- | JOEFRULT 
a i ageaulalas 
ee a 
{ACCESS TYPE a eee 
| 14{ | 
| |  {OOnNATN 
1s} | 15} 
I---I |-- 
6.23.00 
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Job Tables 





ob Line Equation nt ont. 
| eccecncenncennnnnennennnnewennrnecowennnneocnnee 
25) NUMBER OF BUFFERS j21 
26| BUFFER SIZE IN WORDS |22 
an INSPEED (2 WORDS) ie 
31 OUTSPEED (2 WORDS) \25 
| once wennnnnnenncewenaneeeeneennereesenennnsen= 
a POLL REPEAT as 
* POLL DELAY 128 
a C TRACE INFO , fe 
| LOCAL ID PNTR 1% \ 
aH REMOTE ID PNTR [31 
4| SUPLIST PNTR {32 >» REL TO ORIG 
| conn wee wwwnn enn n no nne rene oewen seoeecoeenecoree= | OF LEQ ENTRY 
4i| PHONE LIST PNTR ies 
42| POLLIST PNTR fe 
MISC RRRAY PNTR i / 
b Con Word Table (JJCW 
Jroeceee= worcencoce |ocer atateneatata | Wane nay be any alpha- 
| WANE SIZE | ]  nuneric string, begin- 
| (BYTES) | | ning with an alpha, 
| coccennnesoeeceene | | between 1 and 255 char- 
3 * acters long. 
= NANE = 
| TY 0 = OK 
| enon | pow e nnn wenn noes cwccceocesoce | 01 = WARN 
{ TY | MODIFIER | 10 = FATAL 
| conn | eoerooennceeeee wrecercccocce| 11 = SYSTEM 
MODIFIER = VALUE FROM O 10 2377777 
6.23.00 
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Job Tables 
PARSK U akdoun 
[eoreweo= PARSK WORD 2 
| /---- PRASK WORD 1 
---|---[0 
FILE TYPE a FACTOR 
LABELED TRPE ! |RECSIZE 
FRAS NESSAGE | |OISPOSITION 
USER LABELS | ! {RUMBUFFERS 
LANGURGE ! peaen BUFFERING 
VTERN | ie 
POINTER ENTRY| | Baap abgaiia 
DYN.LOCKING | | |RCCESS TYPE 
WAIT,NOWAIT | | {COPY,NOCOPY 
MULTI ACCESS | | nas CONTROL 
NUTICOP { |  JRECORD FORMAT 
CUTPRI i; | ence DESIGNATOR 
FILECOOE | JASCII/BINARY 
FILESIZE i | Laie 
NUEXTS | | = [0evIce 
INIT ALLOC { [WARE 
1§ 
1 8 info present 
0 = info absent 
6.23.00 
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Jod Tables Job Tables 


UCOP Request Queue (OST # YUCOP Entry Format . 

Each entry is 

2 words long 

The UCOP Request Queue (URQ) is used to to signal UCOP that a process is 
requesting process deletion. The URQ is a circular queue using a FIFO | 12345 67 8 91011 12 13 14 15 
algorithn to process requests. When the next available pointer 18 equal to fon [oe --[--l--]-=]-- lee ben dee be-1-- b> 1-1 --t-- 1 
the next request pointer, then the table is empty. When the next available | 
pointer 18 (logically) one less than the next request pointer and the request | eon nnn nm en nnn enon ener nnererocernnee | -------ce-- |2 PROCESS DELETION 
18 entered, then the table is full. A full table will cause Systen Failure 1 | PIN | 
(SF1). Thus, the last (logical) entry cannot be used. fn entry is added via | penne nnn nnn wn nn nnn nnn ore en nn enenneseenoenne | 





a call to REGUCOP. 


The UCOP Request Queve (MPE IV) was previously used for many functions such 
as stack expansion, but those functions noved to other areas with MPE V. The 
only valid entry now 1s a type 2 entry (process deletion). The original 
fornat 18 retained in the event that more functions are added. 








0| MAX REQ ENTRIES N/2 | 
| eweeeseneceeses ccnsecececsconecocousseccae=cnese 
1| TABLE RELATIVE POINTER TO NEXT AVAIL ENTRY|------ \ 
| ewe cece acne cnc wee coc cee anewesesccecenscosans 
“ TABLE RELATIVE POINTER TO NEXT REQUEST | 
3] 0 1 Joi 
san | serasessencesesocesnersescoerenssseenscrrensets i tl 
Mt | 
; | tr tod 
1 4 ; td 
i | 1 4 
| | 1 tt 
| ; I 
1 4 1 tt 
| [reecccweweernnceewnnneccnenscorcwrnnereccnonces 1; ft | 
} | REQ 1 |<--/ | 
| [enceencenmennnnncnnnnnnnnnanccecnnenacncnnceen | | 
| | REQ 2 | | 
| [eneneanene aownecenennenannnennnenennnnccnnneen | 
1 | . | | 
! | ; | | 
nN | : | | 
URDS | : | | 
| | . | | 
; | . | | 
| [pec ew nen en nnn nen ennnnn cen nencrennnnssceccoccrne| | 
i | REQ N | | 
| [rocew ene nnreennnnnenennersoconnorecsennnesenens | | 
| | | | 
| | [<-----/ 
{ | { 
i | | 
1 | | 
1 | { 
v | | 
wee | cece ene ern ennenncnennnnnnnnnccnewnccnneeseceonn | 
6.23.00 6.23.00 
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Relocatable Object Code Relocatable Object Code 
CHAPTER 9 RELOCATABLE OBJECT C ver. File Forn on 
USL Files Introductisn [ooecennnoecoeee | 
ia SRAD \10 S.A. AVAIL. OIR. 
- USL record length is aluays 128 uords 13] ROL [11 AVAIL. OIR. LENGTH 
- Layout of double-word disc addresses: | eoeecon-onnnene 
14] SAT |12 S.A. INFO BLOCK 
| cower enmnnnnetoncecoecoces [Sestosrecasess=sees* | 15] 113 
| | WORD # | | evonennneneeon=| 
25-BIT RECORD # ! WITHIN RECORD 4 IL te INFO SLOCK LENGTH 
weaceneeccsonscwcacasescce | cmc ecoooecncosavesce 1 
0 24 25 31 | ewownnnnnnen-n=| 
2} SAAT 116 S.A, AVAIL. INFO 
- Hash links join all entries with the sane hash key regardless of o tid 
CROs ce i et ek, Ate 
- Linear lists terninate with a zero link 22| AIL 118 AVAIL. INFO LENGTH 
- Circular lasts containing only the list head point directly to 23] {19 
thenselves | oneeneeeneoneoe| 
- Single-word disc addresses: 24| TOTAL {20 TOTAL INFO GARBAGE 
' ' ae I.G. [21 
| | WORD # | 26! NIG 122 WR. INFO GARB. ENTRIES 
| 9-BIT RECORD # | WITHIN RECORD | | eonooccceennon= | 
cocenreneencnnn: seecercree | o-eennnn nnn nn nnnn- n= | 2?| j23 
0 89 15 | | 
| |24 
- Uninitialized fields are reserved for future use and should | | 
be set to zero. a i 
32| /26 
Record 0 and Overall USL File Forna | | 
+ fad 
| eocceenee coocee | NOTE: x] {28 
0} LTO 10 LORDER 10 S.A. * Starting Address | 
| ---eocennnno---| 35| (29 
1] NE \1 NR. DIRECTORY ENTRIES | | 
co aaneeebiewas 36} 130 
ra OL \2 DIR. wENGTH | | 
| eoocneccnenenee | 3?| (31 
31  SUNDG [3 TOTAL DIR. GAREFGE | | 
coceeenescosane 40| 132 
ry NOG 14 WR. DIR. GARB. ENTRIES oe | 
| enewenececnceee | 4i| HL 0 133 HASH LINKS 
5| SABDL 1 $.A. BLOCK DPTA LIST cpecinaaa 
6]  SAIPL (6 S.A. INTERSYPT PROC. LIST | : 
7| SRSL : S.A. SEGRENT LIST Ma HL 94 inet 
101 FL |8 FILE LENGTH 
1] \9 
|Jroneceennennno=| 
6.23.00 6.23.00 
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to OP 








Relocatable Object Code 


Files General Infornation 


0|----------- 4 ; 
| RECORD O | | 
| | 
| | 
177 | ---ceeeceee |127 | 
{ 
| 
/ mT tocewceeece 1128 | 
| | OIRECTORY | 32K 
| | | FRX 
OL « | ENTRIES | i 
| | | | 
| | | | 
\ Jerceceeenn= | | 
| | 
/ | oocennoene= | | 
| SAAD | | | 
| | AVAILABLE | { 
ADL < | DIRECTORY | j 
{ | | | 
\ [aesescecses | v 
/ SAI® |[----e---=-- | 
| | | 
| |} Info | 
IL | (HEROERS) | 
| {| (CODE) | 
| | { 
i | | 
\ neta Cake 
/ SARI aan. 
AIL | AVAILABLE | 
| | INFO | 
\ | ! 
\ Elct lessexcenne= | 


® SAI nust be on a record boundary 
NOTE: All addreeses in record 0 are uord 


addresses. 
6.23.00 
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Relocatable Object Code 
3 rj P Par 


01234 5 6 7 8 9 10 11 12 13 14 15 
[on [== f==1-=]--1-=1==1--1-= 1-1-1 1--1--1 | 
| doe | STRUCTURE | TYPE | 


nenennennee| => eS eg 


TYPE WORDS CODE 


[--] 
< 
par 
m 
_ 
OX) 


= 
m 
» 
- 
& 4 19 19 -* 


LABEL (SPL) 

CHARACTER (STRING) N/2 11 
LABEL (FORTRAN): 12 
UNIVERSAL (MATCHES RNY TYPE) 13 


STRUCTURE 


SIMPLE VARIABLE 
POINTER 

ARRAY 
PROCEDURE 


RODE 


NULL 
VALUE 
REFERENCE 
NARE 


wrt Oo 


wr-- O 


NOTE: A descriptor of 0 results in an autonatic natch. 


Pascal 


Pascal sets the high order bit in the paraneter type descriptor uhen 
it is generating hashed values. The renaining 15 bits are based 

on a hash of the types of the paraneter. Only the Pascal compiler can 
compute the value, and the SEGHENTER nust natch the uhole 16 bit value. 


6.23.00 
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Relocatable Object Code 


SASL--->| -------- | +[ cooeceeee [-------- | 
SEGL ! wocecoce= | SEGL wowcerece ; 0 ! 
att | arr eet 
| I-\ /-| SUBL I-\ {-| | 
[=Fss2""< It | |eee<s=>- | * [pseserese \ 
v | | | 
| | | | 
[rocncenenseceonee [oor / \psee-= \eeeeetrsseesese \ 
| [ 
| | 
| | 
| | 
| |-------- | o-eon-on=| |------=- | 
ae SUBL oor SUBL | seccccere | SUBL jas 
| PROC.C ! PROC.A ! MAIN | 
| I-\ f=] SER I-N/ | 
|-------- 11 | beeeeeneeel I | J-ne----- | 
ae i 
| | | 
[ | | { 
‘ peceessaveeeseess [aos-5 / \n=-<- \coceceneonaneccenane : 
| CIRCULAR LINK POINTS TO ITSELF | 
| IF LIST IS ENPTY 
| | 
| [ececewmn} = omens see [nseseee | 
— SECL ~ coene ma SECL eeocenn= oe SECL om 
| PROC. | j PROC.A | | PROC.A | 
| 3 | | | | 5 | 
| | | | | { 
[aseereee | Jevennon~-| [eoceeece | 
A \ Proc C \ 
K > Segnent nane entries PROC AR >Subpregran 
8 / MAIN §6/ entries 
A \ 
3 | 
A | 
P Secondary entry point entries 
5 / 


Relocatable Object Code 


45 6 7 8 9 10 11 12 13 14 15 








| 

| 

| 

| [oe] eeneeennonencwenccnercenenwnn|soreennnonnnnn| 

| | | 

1 | | 

i | GARBRGE | 

i | | 

1 | | 

| |-eeeenencnenennennecnnnnneennonenncenenecnenee| 

Entry Type! 

SEGHENT NANE 

| 1119991 

} 01234856789012345 

1 lef-l-l-f-let-lef-lel-f-l-l-l-l-1 Mu - Nunber of words in entry 

‘| Nu | { block 

1] HL | HL - Hash link - points to next 

ee ee ee emmeemand | entry having the sane 

a nC | CHARI | hash code 

| 3] , | A - Retivity bit 

i | (VARIABLE @ CHRA. SEE KC) | 0 if active 

it. | 1 if inactive 

It. (initialize to 0) 
] CHAR. WE Note: Rn inactive se 
| ewoon roe nee= woe | ecccoccwcwsooce implies that all entry 
| SEGL points are inactive 
itl SUBL NC - Nunber of characters in 


nane. flax is 16 
CHAR. 1 - Firet character in 
variable field 
CHAR. NC - Last character in 
variable field 
SEGL - Segnent link - points to 
next segnent nane entry 
SUBL - Subprogran link - points 
to next entry having 
the sane segnent nane 
L - Last entry in list 
© if not last 
1 aif last 


| o | 888 2S08 80 6222228829828 880880S280 
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012 3 
olelreirleletel ile -isi isles), Matar t-seres insite 
| Nu 0 | block 














Relocatable Object Code 
Clarification Notes on En Types 2 and 4 
Wath Respect to SPL and FORTRAN 


SENTRY TYPE 2 *#ENTRY TYPE 4 ENTRY TYPE 2 **ENTRY TYPE 4 


SPL 0.8. SPL PROC FORTRAN MAIN FORTRAN SUB. 
TPDB 0 0 0 
1,5 1 1,2,3,4 1,2,3,4 
TSOB TSOB TSOB TSOB 
NUPUST NUPUST NUPUST NUPUST 
5 
NUSDB Nuo NUD NUD 
linere: TPOB = Total prinary O08 length in words 
TSOB == ~=Total secondary 08 length in words 
NUPUST = Nunber of words in “TRACE” array 
NUSOB == Number of words in secondary DB array 
NUO = =_~—s Number of words in oun array 
z 


Nunber of words in data array 
Notes: Does not include the length of the STLT 

Does not include the length of the FLUT 

Does not include the length of any connon array 
Includes the length of any OB-allecated fornat array 
Rre not necessarily equal 


mewn — 
o 8 «© @© @ 


In general TPDB and TSO8 are sunnations of storage allocated in the global 
area of the progran’s data segnent. They are not, however, conplete since 
the conpilers are not aware of ali storage actually allocated! The STLT 
and FLUT are exanples of this since these tables are constructed by the 
segnenter. Connon arrays also present a problen since their inclusion in 
TPDB and TSOB night cause their storage requirenents to be counted nore 


than once. 
G. 23.00 
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Relocatable Object Code 
ntry tT ont. 
| [onvncecennennnnnn-onencnnennccennnnncenennnene=| 
, | ‘ | 
; | , | 
} | ‘ | 
| [ennnnenennnnnncnerensnne anenennnnnn-e o-anno-——| 
} | HOU { 
| |oneannnneeennoncwennnnnnncnnne= wrncneneneennene| 
; | . | 
: | ; | 
i | : i 
| [ea] -n-ea--nn--nnennnnnnnnnncnrarnnnnnnconnnenn| 
1 Tl NH { 
J [ec feceennn nnn erec enn e ween wc wwne wenn nnnnnnrennee | 
1 | | 
) | SAH | 
1 | | 
| |eeeennnnnnnnnnnnnnnnnwnnnnnnnennnenennenncnnnne| 
| | KDW | 
| [ecanvencnnnnnnncennnecnnnnnennennmwnnnnemeowen=| 
PP: 
| | : | 
aaa 
1 | HOW | 
1 | 


NW - Nunber of words in entry block 


HL - Hash link - points to next entry with 
sane hash code 


A - Activity bit - 0 if active, 1 if inactive 
cuter block 


C - Callability bit eet if entry point is 
uncallable 


I - Privilege node bit - set if progran unit is 
to be executed in Privilege node 


NC - Nunber of characters in nane - nax is 16 
CHAR. 1 - First character in variable field 
CHAR. NC - Last character in variable field 
L - Last ertry in list 


O af not ‘ast 
11f last 


6.23.00 
§- 9 


ee er es ES ee eee 


Relocatable Object Code 
Entry Type 
OUTER BLOCK 


012 4 6 7 8 9 10 11 12 13 14 15 
on fedesdeteslenletendeen dort eztl 


| 

| 

| 

{| HL | 
[) bee [sel ae =*|osesseseces [seen endeseecessseennn= | 
| Patch m {| we | CHAR 1 | 
! eae Soeonetess a 
| 4 (VARIABLE # CHAR. SEE NC) ! 
[ | 

[> = |RReteenstesesseeeeseess [asworase=seacoesencses= | 
| | ' CKAR NC 
| ‘ SUBL | 
, ful SECL | 
I a ca ae a el 
, | SSA | 
lL) > [eeatececernse ster snseeessersarsetoersrineseaa@= | 
| | SAC | 
1 | RELATIVE TO SAI | 
1 | (SEE RECORD 0) | 
[. ee lentnccgssasteercessseceecnsterscerecs-Ssosor | 
{ | Fl ul NC | 
}\ Glee [se lsarassassesesssecrosanmressseessoraner se | 
| | SE | 
I aaa ror | 
| | TPOB | 
|]. Absasseseceteneacseesenesssse Sseseceretassesnse== | 
1 | TSO8 | 
}: . Wap hieeseseenameensessse cess ssananerenseesess= ~=| 
| ! NUPUST | 
i | NUO/NUSDB | 
“les |arsteseceencccra ac aesaaessesreenareese ese ser | 
{| | WH | 
[iv deslesesessteesasascesenenescencaresseseseess<se | 
, | SRH | 
; | RELATIVE TO SAT { 
(SEE RECORD 0) 
| HOw | 


6.23.00 
9- 8 


Relocatable Object Code 
ntry T Cont. 
SUBL - Subprogran link - points to next entry 
having the sane segnent nane 
SECL - Secondary entry point list link 
SSR - Progran unit starting PB address 


SAC - Starting (FILE) address of code 
nodule 


F - Set if fatal error 

W- Set if nonfatal error 
WUC - Kunber of uords in cede nodule 
SE - Stack size estinate 


TPDB - Total nunber of words of prinary 
DB to be allocated 


TSOB - Total nunber of words of secondary 
DB to be allocated 


NWPUST - Nunber of words in trace array 
(PUST) 
NUD - Nunber of words in data array 
(FORTRAN) 


NUSDB - Nunber of words in secondary 
08 array (SPL) 


T - Terninating bit - set if lest set of 
headers in entry 


NH - Nunber of headers 
SAH - Starting address of header (relative 
to SAI) 


KDW - Header (pointer) 


6.23.00 
9- 10 


Relocatable Object Code Relocatable Object Code 


Entry Type 3 ntry 7 4 nt. 
| 01234 5 6 7 8 910 11 12 13 14 15 
OUTER BLOCK - SECONDRRY ENTRY POINT | feels et stele lenlostecletleieateetel 
; 01234 5 6 7 8 91011 12 13 1415 | sac . | 
i eed foe ed es bd od rd od lO ed | | 
} | [| Ni | 3 | nn [on [eonnrennnnnenenn on nrnererronsennennoonnne | 
| [en forececencnenenneerneeennnonee |seerseeeas=ee= | JF | ul NaC | 
| HL | | nn [on [-n-ne wenn nennn en nn neem nnn nneenenreennnnnne | 
fe ed ed ed Cd Cena, | SE | 
1 fabch | g we | CHAR 1 | | eeennnen conn w enone nnn neennnn on ccernnnneccceena= | 
Joe [oe lee|--[-nnnn rere Joreeserensseesesesesse TPB | 
1 | (VARIABLE # CHAR. SEE NC) | Tsb8 | 
; | cee ee Nh ULUmUt—“<itw””s”*”~*~*~*:*s RRR SK ORR RRS Re Se Ae See S 
| [eooweororensensorconsee | onrccronncccccennensece | | NUPUST | 
14 CHAR NC | | | proe ne ennnnnnnonecee werwernecccocw cence ennnnnne | 
|: “ [ee [essaeHsesesseseerse= [sSecasaeasdeanses<seces | | WUD /NUO | 
} [Ul SECL | | feee=- [oeqneessecaeseuse=|oecesetaressersi=ssere | 
[> (se seseswessseeeseesees se secesrearaes-esra rere | ; | P| NP | CN | 
| | SSA | |). dese [aesanteessosseree [seaneerese-sesseresc es | 
| [ecceneencencccennennnnnanecennamnnnnenannances (e. | 
| PARN.1 | 
Entry Type 4 conn ccw enn nce eenwncen cc conoces en sessesseesnnre ! 
| (VARIABLE # OF PARNS. SEE CH) | 
PROCEDURE ! ‘ 
| 6 7? 8 910 11 12 13 14 15 | PARN. NP | 
ie ted od et od Do ol od oD oa |= |------naernnnnennonenee nocenenernncnnnneoee | 
| Tl NH | 
[. “sitelerescesesercsceneres= aad aes (abe | -roeenmwcwwennwnwnnwewennncccorcnnnnnrccrors | 
| HL | | | 
| leelee|--]--]---eennenee | coewnaceeocoece= erceene | | SAH | 
| JA; CL Iya} we | CHAR 1 | | i 
| [--}--l-=]-+]-seeeee-22- |noonennnnnnnnennnnnenae | | ----ennnnonn--nnennnnennnnnenencnnwnnnnnne oo-e-| 
‘ | | HOW | 
| (VARIABLE # CHAR. SEE WC) | aoc cccewew tenn nnnwewwe nen nseenencoonenecnocce= | 
| onnnnnwencenenceneenne= | pomeen een onwcenoeeenn n= | | | 
; | CHAR.NC | | | { 
b> [ss |sseseraaqeseeeansese | conewnensnewsccocconene | |~nenseee< cnenncseee cueeneosccors Seewsacenss-5s2 | 
it SUBL | HOW 
Ju | SECL | ‘ 
| SSA | ee | 
[eeeoneneanensedecrtessesetanssseanereersasssse= | J-one=-- mecnanwncccwenneneceerennnnneneenwoorsnn | 
| ETc | 
|-----een----~- wonnncneccennnnnnennnnen nnn neenne| 
6.23.00 6.23.00 
9- 11 9- 12 
Relocatable Object Code Relocatable Object Code 
Entry Type 4 (Cont.) n T 4 n 
NU - Nunber of words in entry block NUD - Nunber of uords in data array (FORTRAN) 
HL - Hash link - points to next entry with sane hash code MUO - Nunber of words in oun array (SPL) 
A - Activity bit. O if active, 1 if inactive entry point P - Paraneter checker 
00 no checking. (Inplies KP undefined, FN and PARMs absent) 
C - Callabilaty bit set if entry point is uncallable 01 steel inane type. (Inplies NP is undefined and PARMs 
absent 
I - Privilege node bit. Set if procedure is to be executed in 10 check ous type and nunber of PRRs (inplies PRRMs 
privilege node sbeent 
11 check procedure type, nunber of PARN ’s and type of each PARH. 
H - Hidden entry point. Set if entry point will not be in 
library directory NP - Nunber of PRRAs 
NC - Munber of characters in nane. Max is 16 CN - Character count of PARMs 
CHAR! - First character in variable field TH - Abily Type (see Data Descriptors earlier in this 
chapter). 


CHAR NC - Last character in variable field 
T - Terninating bit. Set if last set of headers in entry. 
L - Last entry in list 
0 if not last 
1 if last NH - Nunber of headers 


SUBL - Subprogran link. Points to next entry having the sane segrent SAH - Starting address of header 
nane 


HOU - Header (pointer) 
SECL - Secondary entry point list link 


SSA - Unit starting PB address 

SAC - Starting (file) address of code nodule 
F - Set if fatal error 
W - Set if nonfatal error 

NUC - Nunber of words in code nedule 
SE - Stack size estinate 


TPDB - Total nunter of words of prinary 0B to be allocated 





TSOB - Total nunber of words of secondary 0B to be allocated t 
NUPUST - Nunber of words in trace array (PUST) 


6.23.00 6.23.00 
9- 13 §- 14 














Relocatable Object Code 


ntry T 


PROCEOURE - SECONDARY ENTRY POINT 


| 345 67 8 91011 12 13 14 15 

| i ae o-|--|--]--] 
I ected eee ae ]eoeenenennn one 

1 | HL | 
| [en |e-]--l--]------2-22- |--onn-nnnnnnennn nn nenee 

} jarcy tH] wc Ot CHAR 1 | 
or coececccese | eownennnnneeennnseoenn= 
| | (VARIABLE # CHAR. SEE KC) | 
| [receeccee socncocowccnn= | eoennen nn nn enn ne nnnnnn= | 
| CHAR. NC | | 
a Ned etal | 
1 Wel SECL | 
| ea [en nnn en enn e nen new en nc nwo ronnensnsoncnscowone | 
| | SSA | 
| [eee ew ewe ww cw nnn n ewww nnnncn wwe w wren omen secnnnce | 


NU - Nunber of words in entry block 


HL - Hash link - points to next entry with 
sane hash code 


A - Activity bit. O if active, 1 if inactive 
entry point 


C - Callability bit set if entry point is 
uncallable 


H - Hidden entry point set if entry point 
will not be in library directory 


NC - nunber of characters in nane, max is 16 
CHAR 1 - First character in variable field 
L = Last entry in list 
0 if not last 
1 if last 
SECL - Secondary entry point list link 


SSA - Unit starting PB’ address 


6.23.00 
9- 15 


Relocatable Object Code 
ntry T n 


NU - Munber of uords in entry block 


HL - Hash link. Points to next entry 
with sane hash code 


A - Retivity bit. © if active, 1 if 
inactive entry. 


IT - Interrupt procedure type nunser 
NC - Nunber of characters in nane (naxinun is 16) 


CHAR 1 - First character in variable 
field. 


CHAR NC - Last character in variable field 
IPL - Interrupt procedure link 


DBS - Nunber of words of D8 storage 
required 


SSA - Unit starting PB’ address 


SRC - Starting (file) address of code 
nodule 


F - Set if fatal error 
U- Set if nonfatal error 
KUC - Nunder of uords in code nodule 


T - Terninating bit. Set if last set 
of headers in entry 


NH - Nunder of headers 
SRH - Starting address of header 
HOW - Header (pointer) 


-_-- —- ee eee so 0 cheep inating Pear 2 ee owe - - ce eee ee eee ee eee owe oe 


Relocatable Object Code 


INTERRUPT PROCEDURE 


01234 5 6 7 8 910 11 12 13 14 15 
[--|--[--|--[--f--1--1--1-od-- deen dee t ee teed -- | 
| Nu | 6 | 


(VARIABLE # CHAR. SEE WC) 


Di 
o—4 
_ 


| 

| 

| 

| 

| 

| 

| 

| 

| 

| | NC | CHAR 1 

i Nedeeel leer |-eenennencennenennnnne= | 
) | (VARIABLE @ CHAR. SEE NC) | 
| ‘ 

| |oceenlennnnncnnennnnann | -naeneeennnnnenaeneenne 
| CHAR. NC | ! 
; | IPL | 
| [ovennneceeneneneenenncnncenncnnennnnneneneceans | 
) 4 DBS | 
| |oneenennnonnnnnnnnnnnnnnennnnnnenansnnnennnnces | 
i | SSA | 
| [eeeeennnenannnnnnnnnenennnnennonnnnenenneennnns 
| | | 
t | SAC | 
[| | 
| [oe |oc|ennnnnncenneeeanceccennnnnrennnecnene --| 
| |r} ul = muc | 
| Jac |oc|eceenennennnnecceennennnnnennenennnnenn= 
| it] Xi 
| [on |oceennnnnenennennnennnnnnnnnnnenenecanenns | 
| | | 
| | SRW | 
| | | 
| |oeeeennnnnnennnennonnneennnnnes wecennnnnnnnna= | 
{| HOw | 
ee ennenenenennnnneneneoe| 
ij. | 
fy. 
Plo. | 
em | 
| HOW | 


6.23.00 
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Relocatable Cbject Code 


Entry Type 7 


BLOCK ORTA 


041234 5 6 7 8 91011 12 13 14 15 
|-=|--|--[--Je-f-- foe foe tee | --1-- beef --l--l--1--1 
1 4 NU 7 | 


| HL t 
|a=]=-|=-]-=]-n-enenonee |-nnnnensennnnencenesnes | 
inie iw} | NC) | CHARA | 
ia eS lero leae eee | 
BLOCK OATA NANE | 
: | 
CHAR NC | | 
wecwece a consenwseewoees | coc cworcouw one ncoscence | 
BDL | 


q 
4 
' 
’ 
a 
$ 
6 
4 
9 
i] 
t] 
$ 
4 
‘ 
i] 
¢ 
LY 
¢ 
t 
4 
] 
¢ 
A 
‘ 
e 
‘ 
8 
t 
‘ 
‘ 
4 
6 
q 
8 
i] 
) 
i] 
4 
r) 
¢ 
‘ 
§ 
] 
‘ 
8 


: | 
COMNCN ARRAY NARE 

we ene en ncn en nee een mene | eo een ne: coweneene-scen| 
CHAR. NC | | 

ne [--nnerenenennennne = |-nn------nonn2-nenee ne | 
|v j NH | 
Joe [nomen ne ron n nnn nme we nnn nnn nn nnn nme ceen cones | 
| SAH | 
| { 
| conn n nn nn nme een ne mnnn-- oem erence cowenoeseocee | 
| HDW | 
| penn enone nnn n nee n nnn enn en nnn sen cee ncoeenen=o= | 
| | 
| | 
j | 
| enon en enn ene mewn ene we nae een ne nnn nens cenceenee= | 
{ HDU | 
ee bane weenie tate 
ee | 
| | 
| men nnnn enw nnnn-n cee nnn n nen en nen nen en nneennene i 

6.23.00 
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oe — 


Relccatable Object Code 


1234 5 67 8 91011 12 13 14 15 


wecene econ eee eeeeneeeee | cweeson seeeaeeeoeaaecoece 


iT | NH 

ar ~~ «as 
ar ie 
a 


SS SC Sees RED ERAS GE ES EE EE OE CE eR cee ce dh Cre Fel Gam ace 

- 
x 
>] 
= 
° 

=z 
o- 


NW - Nunber of words in block 


HL - Hash link. Points to next entry with 
sane hash code 


A - Activity bit. 0 if active, 1 if inactive 
block 


F - Set if fatal error 
UW - Set if nonfatal error 
CHAR 1 - First character in variable field 
CHAR NC - Last character in variable field 
BOL - Block data link 
CAL - Connon array length 


T - Terninating bit. Set if last set of 
headers in entry 


NH - Nunber of headers 
SAH - Starting address of headers 
HDW - Header (pointer) 


6.23.00 
9- 19 


Relocatable Object Code 
ntry T fn 


CHAR 1 - First character in variable list 


CKAR WC - Last character in variable 
list 


L - Last entry in list 
0 if not last 
1 if last 


SECL - Secendary entry point list link 
SSA - Unit starting PB’ address 


P - PARA checker 

00 No checking (Inplies NP undefined, 
TW and PARAS absent) 

01 Check procedure type (inplies NP 
as undefined and PARNS absent) 

10 Check precedure type and nunber 
of PRRAS. (Inplies PARNS absent) 

11 Check procedure type, nunber of 
PARAS and type of PRAM 


NP - Nunber of PARKS 
CN - Character count of PARAS 


TN - Procedure type 


6. 23.00 
9- 21 


Relocatable Object Code 


Entry Type 8 


PROCEDURE - SECONDARY ENTRY POINT 
345 6 7 8 910 11 12 13 14 15 


ed eed ed dd fod oe eo oe 


| 

| 

| 

| 

; | HL | 
| fet bee lee leo feneoeennnne [oom non ron cercccertereen | 
} fajc! Ini Ne | CKAR 1 | 
| is eas soceennowen | coronene nn nnnrecornece | 
| | (VARIABLE # CHAR. SEE NC) ! 
] | roeweeereccerenseneee- | eoewerew en ennenernecnne | 
| | | CHAR. NC | ! 
| i SECL ! 
i | SSA | 
J fre |ennon nnn nneennnenee- | enennnn nnn nnneennnnne- | 
| IP f NP | CH | 
| [oa fenonwowoeeenn ane nene | eoeecono nw eeneccennnnn= | 
i} | TN | 
| eee enn nn nen nnn nw nnn nene ne wnnennennnccencecorcs | 
| PARN, 1 | 
| [rowee nen nc ew ec cence ewnnwnnnwnseneoncnerececcoee | 
} | . | 
t | : | 
) | | 
| [eowenecnen www ecwenwecnnnnnsowcosocsorcosowecen | 
| PARN. NP | 


NW - Nunber of words in entry block 


HL - Hash Link - points to next entry 
with sane hash code 


A - Activity bit. 0 if active, 1 if inactive 
entry 


C - Callability bit set if entry point is 
uncallable 


H - Hidden entry point. Set if entry 
point will not be in library 


directory 
NC - Nunber of characters in nane, max 
is 16 
6.23.00 
9- 2 


Relocatable Object Code 


Entry Header Fornat 


| -o---ennn--eoeeee | 
SRH aaa HERDER 
| | 
| | 
| | 
 Koetetatecatatereetetaeetetate | 
| HERDER | 
| prone enn n ew ewene- | 
| on ---- ene en neon | 
SAH aaa HEADER 
| | 
| | 
| | 
| ----------------- | 
SAC ------->| CODE ! 
| , | 
| : | 
. | 
| HEADER | 
| eacuconetoas 
SAH = KEADER ! 
| | 
| | 
| | 
|---eoeen nnn | 
]| HERDER | 


Each entry (except secondary entry point entries) must describe N > 0 sets of 
headers. The headers in each set sust be continuous and in the sane order as 
the HOW list describing the set. 


The code nodule nay be czaced in anv position in a header set. Note that if 
the code nodule as at the beginning of a set, SAC = SAH. 


If the entry has no header set, then NH, SRH sequence is absent. 


6.23.00 
9- 22 





Relocatable Object Code Relocatable Object Code 


Header Type 0 Header Type 2 


GARBAGE PB ADDRESSES 


5S 6 7 8 9 10 11 12 13 14 15 


7 8 9 1011 12 13 14 15 4 
fonfeeslesldenkosbeterdte- fori tosll 





| 

| | 
| | | 
| | . ; 4 PBA | 
GARBAGE | erence enn + ret ere ce cn cecnennwescn cron seer ee eee 
|-no--nccnennnnnneenennnnnnnnnnncnnnn nee nnennns | 1 | 
| | | 
| [oemencnoenncnnnnnnnnnnnrennnnncnncnenencccenncs | 
Header Type 3 ; | PBR | 
| [ecennnncnnnencncennnnenacecnencenencnnenanennns | 

PCALs PBA - PB’ address of PB address 


to be corrected 
345 6 7 8 910 11 12 13 14 15 





| 
| 
| | gader Type 3 
| [ea |onecennnnnnnnnnnnnnnnnnewenne | onnnnnenenenen 
i if PBA 
| [eeeweweween | eccnnencene | eee eew ne cenccecccoeee --| GUN / DATA VARIABLES 
1 | |} owe | CHAR. 1 | 
| [ewwcceenewe | concnc econ | oeneenennwoesenennnone | | 01234 § 6 7 8 9 10 11 12 13 14 1§ 
f |. | eee eee oo de Pe bee ea ala 
1 | : } i; tt NU | 3 | 
i | : | | Jeol ereececen ere nnnonencererecen | eweeenenennnn= 
| [ecwewew enn nn ecececocwne | eonennnecnnncsernconnn { } {8 PBA | 
| [esonefeceness | | De | 
f | P J NP | CN | t | . | 
I [edeetated betatetetatatetatatatatateneatatet | cocenenennewenrnnecoce= | i | : | 
: | TN | | Jee enn nnn nnn nnn ne ene nnn nro e new ennnnnnenececons | 
| [eneewcennnnnnccnnncnnencnnnncnnennececsnemmeens | | {8} PBR | 
| | PARN. 1 | | [en |-cenenenneennnennnnnnnnnenenenencenncnnnnnwe | 
rs 
tf to. | PBA - PB’ address of oun variable 
| . | pointer to be corrected 
| 28S 9208 EOSSE4 EBS SE FE OOO 8S ESE 2 OSE 2 O89 SEE2SHS 2OSSOSHTEO | 
} | PAR, WP | 
| 8 OOS C889 O9S E8408 8S £84 OSS8 OSS SO SEESE 2ES8 SESUVSESEECO | 
PBA - PB’ address of linked list of PCAL instructions to be repaired - 

lower 14 bits used as negative disp. - bit 0 set means that 

the uord 18 not a PCAL instruction, but a pointer to a SST label 

of “EXTERNAL” fornat - a link of 0 terninates the list - bit 1 

eet neans that the word is to be initialized with the PB address of 

the procedure. 

6.23.00 6.23.00 
3- 23 9- 24 
Relocatable Object Code Relocatable Object Code 

Header Type 4 NOTE: All references to the PUST include the four-uord header 


that is appended by the segnenter. These words are not 
present in the header; they are autonatically 











DSOB / CUN / DATA / VALWES allocated and initialized by the segnenter. 
| 123 4 5 6 7 8 9 10 11 12 13 14 1§ Header Type 6 
1 I- a a-|--|--f--]--l-- fon deel -- bee} --1--1-- 1-4 
- ! NW 4 | GLOBAL VARIABLES 
i | LD | | 012 34 5 6 7 8 9 10 11 12 13 14 15 
| |ene|ocencnncncnncnnnnennneewannnnnenccnncencnns | od ee eC ed Oe OOD | 
; | 8| IN | i; tl Ku | 6 
| Jere |nennnnnnnnnennnnnnennnnnnnnnnneeeneennn anos | | [--[-eennnnncennnnnnenen= annnnn-=|-= ---| 
{| | | | ™ | 
| | INITIAL VALUES | | [eereeeeneneescenwonesce | eoennennee | eo-| 
1 | | i ot O6A | nc 
| [eceneencennnneceennnnnnnenerenannnnnneneneenon=| | |[eeenencececennceenennne |--w--n--nn=|-----e-en--| 
| CHAR 1 | CHAR 2 | 
LD - Logical uord displacenent | [owen nnn nn nnn nme ene nn nnn | eonenennnne | 
in oun array for initial values . 
B - Byte bit - set inplies that WD is i ol . | 
type BYTE and that the first Catetetetetatetetatetehctacecetereteteratates | ennen wow nnn ne nnn nnnenee| 
word of the initial value block | | CHAR KC | | 
is a count of the nunber of bytes | [ree w enn nnenennennnneene | eooen owen nwereneneennnn | 
in the initial value block 
IN - Integration nunber - nunber of Header Type 7 
tines the block of initial value 
is to appear in the secondary 80 - EXTERNAL VARIABLES 


1 - no duplication. 


2 - duplication, etc 0123456789012345 PBA - PB" addrees of linked lists 








| 
| [ebedebet-d-l-lefelel-t-l-d-l-l-l of instructions to be repair- 
i td NW i} 7? | ed;lower 8 bits of inst. used 
Header Type § | [rb eceeneneoncenenoece | conwccece| as neg. displacenent to next 
; | TN | instruction; a link of 0 
ee ol Roe Poe Pe terninates the list. 
PUST | Al } we | CHAR. 1 | 
J [e | enenn [enon nn- [enone enone nnnne| fi - flenitored variable bit; set 
| 0 6 7 8 91011 12 13 14 15 ; fo. | if variable is being non- 
onfntetendsteebstedendsdenl=toe | | itored by OEBUG. 
| Jon freee nn wen enw en nn weenwnnrnnnne | eneeenennn- ane | [eew ne nnnnenwwne [ocmeoennccccee=| 0A - Logical uord disp. in PUST; 
{ | 8l PBA | { t  Cnar.nc | louver 8 bits of word will be 
ee eed fo etn hed | | eee e creer cowcne | cocercewoneewen init. with prin.OB address 
i | | 1 oA of variable; OR is present 
| 4] INITIAL VALUES | | f eee cere c cece ecceenewecewcnce if As 1. 
ay i ot | | | PBA [ 
} Je a ecwownecccnccncconercwsesesenccco= nce | ! [oovoverronrnereeceerereremeen ent NOTE: PBA of -1 inplies null list 
PBA - PB’ address of linked list of i | j 
pointers to be initialized with i | | 
OB address of PUST (sane dist | [even e-o- conn enw n nn nwcceeconcnne| 
fornat as for format strings 1 | PBA | 
A PBA of -13 indicates NO F * ups. | Jere reec cone ne owen emee eee ecene | 
6.23.00 6.23.00 


9- 25 9- 26 


Relocatadle Object Code 


Header Type 8 


PRIMARY 08 


12345678901 
eeltetlel-F “leet 
Nu | 
|-)---[---f---]---1-1- font fons | 
ju ju ju qu tu tu tu | 
ls 1127397415167 1 


ju ju ju ju WW f 
|N-S|N-4|N-3|N-2/N-1| 


| 

| 

| 

| 

{ 

| 

| 

| 

| 

| . 

| Jewelers fore | one] one [eorenennee= 
| | 
| [ 
| Jecelone|ore|-ee [ore |-nneeeeeen=| 
7 | 
! INITIAL VALWES 
| | 
1 | | 


2802000 SS8O2 20844 28E8E806 C22 8EE8CR 


U - RODRESS BITS 
00 if no address 
O01 af no address 
10 if word address in secondary 08 
11 if byte address in secendary 08 


N - WUPDB 


NOTE: Initial addresses that are 
secondary OB addresses are 0 


Relative (i.e., they are 


logical displacenents in 
secondary 08). 
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Relocatable Object Code 
Header T A 
WUC - Nunber of words in connon array 


NC - Nunber of characters in connon 
nane ~ if blank COMMON 4 CON’ 


DA - Logical uord disp. in PUST - louver 
8 bits of uord will be init. with 
prin. 08 address of varieble - NOTE 
OR is present if Ns 1 

B - Byte bit 


© if the primary 08 pointer to be 
aliccated and initialized and LD 
are of type uord 

1 if type BYTE 


N= Honitored variable bit - set if 
variable is being nenitored by 
DEBUG 


NL - Nunter of address lists for 
variable 
LD - Logical displacenent of variable 


in connon array 


PBA - PB’ address of linked lists of 
instructions to be repaired - 
lower 8 bits used as negative 
displacenent to next instruction - 
3 link of 0 terninates the 


list ‘ 
PBA = -1 indicates NO FIX-UPS 
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Relocatable Object Code 


Header Type 9 


COMMON VARIABLES 


012345678901 
Tee 
NU | | 


| 
I | 
| [a] cower ernnoeeneecee- |--- | 
; | Nuc | 
| eeeeeee | -coeeee [ooreeeeenneneee 
i ol | wc 1 CHAR. 1 | 
ee Ce |-eenen=|-nnnoeneanenn-= | 
1 | | 
; t. { 
; ft . | 
| |enevenecnnnnce= | --------=-a-=-= | 
1 CHAR. NC | | 
| [-|-|-ceene=se-" |----------0---= | 
| BIN} NL | 
| Jel efenee renee nnserennnnonenecce | 
i LD | 
| [reewennenneenecenecoweconcceren | 
{ | DA | 
HE Ketetecetetedetetetetatateneneindebenetaiebennatetteteaial | --- 
} | PBA ; * 
ee een 1 | 
; |. | | 
i | . | NL 
to. | | 
| [reno nneeecenennescconncocnwncen ; | 
| | P@R } ov 
| [reecccrcccecewornwerneneccorone | ee 
| | . | 
| |. | 
; | . | 
, |. | 
rd. | 
| [eel enreeroeenneeenewenrencnnnne | 
| {BIA NL | 
| [a]-|-oennnnenenennnnnnnnennenne | 
; | ww | 
| [eewcoreneenacwerereccocooccocre | 
| | DA | 
| [recercceceneenwewerencnccrowee | 
| t PGA | 
| [ecco cece ee eee nen ener en nnncennen| 
t J. | 
; | . | 
| | | 
| [reece ceecennnnneneeecncwerenenn| 
! | PBR 
a eteetatenetataateeteeneae wecccccrconn=| 
6.23.00 
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Header Type 10 
LOGICAL UNITS 
| 0123456789012345 
1 f-l-d-t ieIeleitei rie eet 
i; dl } 0 | 
| {- a 
i | | 
; | | 
i | | 
1 | BIT NAP | 
| | 
| | 
i | | 
| [sere eroewen ncn eccenecnnamenee| 
BIT MAP - Bit nap of legical unite 
referenced; bit 0 
corresponds to LU 0, etc. 
(1 lees than or equal to W 
lees than or equal to 39) 
ader 1 
FORMAT STRING 
| 012345678 2 01234 
| I-f-t-I-1-1-I-l-l-l- rietarr 
| 4 NU 11 
| [-|-ceennnonnnnenneen=f o> -----—-| 
i | P&A | 
| [ooceeceewes -neewmncwemecon conan 
} ot nc 
| aarrrernaael maar 
| | CHAR. 1 | CHAR. 2 
1 | i 
;t. | 
f Jt. { 
|] [eennneccon nn one [ecwennennen enon] 
i | CERR. NC | 
| Jeceeeerenceeeee sccccwonnen econ | 
PBA - PB’ address of linked list of 
pointers to be initialized 
lower {4 bits of uord used 
as neaative displacerent to 
next pointer - bit 0 set 
means that the pointer is to 
be type BYTE - a link of 0 
*erninates the list. 
6.23.00 
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Header Type 12 Header Type 13 & 14 
| 012345 a a ae 
} 0123456789012345 | l-f-lel-l-l-f-l-l-l-l-leletet-l- 
P teleleted-I-fed-tt-d-tel-l tot |i Wedel 
0 o| www meme eso ceeeneesn | cosecurece 
o | comcennnenenonewece |-neneena= | | IO NUMBER ! 
TO NUMBER | bree en enon en nee coceccconworeone 
eg cere eaten cats | | | FATHER - LINK ( = 0) | 
| | eeewnnnnennnnne- Mepenaecseeeese 
BROTHER - LINK ( 2 0) | 
eHeader For Header Type 12000 eee Pewee tr rworornnonnsvececccececce 
SS | | SON - LINK ( = 0) | OFFSET OF 1ST SUBROUTINE, OR 0 
| 01234567890123485 | | poce owen nnn oncnnceccowenccere --| 
| |-|rooonneneee--  Ketatateietacanaeitetanenian | | | NEXT - LINK ( 2 0) | 
| 1x| NU { SUBHDR | | | one ec eeennnne | eee coecoewennn | 
| ] =| eeenennne nnn | enn e nen neeneene | ! we | CHAR 1 | 
[ OFFSET creneereresones J oownwnenweonece ! 
[asecseareseasesenesaersnacnsss ¥ 
{ | FATHER - LINK | | IF SUBRTN. PARM OR LBL, ELSE 0 | | ‘ 
| | eeceneeessersee | eeenesseeseen = - 
| | CLASS | TYPE 1T] I = 1 IF INDIRECT | | cone ew nneeeoeee | eooneeonooennee | 
|  Ceaceteteteereretetatememeed  Sacatatetenetatetanetatata |-| TYPE = 0 IF NO SUBTYPE | | CHAR NC | | 
| | MODE | RODRESS | | | oo -nnn nee ennnee | erecewwennnenne | 
| | cone oncce senna [acon cceococcn =-| | | LEVEL | SPL | LEVEL 2 0 IF TYPE 13, 1 IF 14 
ned - mf OFFSET OF PRECEDING SUB., OR O | | eneennenneennne | en oeew enn nence 
f | wx | | CHAR 1 | For Header Type 12, 13, & 14: 
[  |aeeenee |oneennn fore nennone nnn n | 
i | [ Nu - The total length in words of the header. 
; 4 | 
| | | SUBKDR - 0 if non-variable, 1 if var., 2 if PB array. 
| [ecowerennnennn- | eowennnnenecen= | 
| j CHAR NC | | TD NUMBER - A unique reference for each block. (A bleck is 
| | pence enon ew eene | eoennnn once Je--| a procedure, subroutine, or the outer block.) 
| | |SPLI This nunber is kept in the 24th word of record 
| | [esewsewseenesnsseceesaseoe= |---| zero of the USL file. It 18 incremented every 
| | VALWE | VALUE OF EQUATE, tine a block 18 processed, and survives fron 
| | penne nnn nme mwnewn nnn nnn eeesoen= | ENDING CODE OFFSET OR PARENT conpile to conpile as long as the USL file is 
SUBROUTINE IF SUSRTN PARAMETER, not initialized. 
PO-REL OFFSET IF LABEL, 
OTHERWISE 0. v - Set to 1 if this is a nodifiable identifier 
(i.e., a variable). 

OFFSET - A number assigned to each identifier uithin a 
block. When conbined with the ID Nunber, this 
uniquely identifies each identifier in a progran. 

6.23.00 6.23.00 
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Relocatable Object Code Relocatable Object Code 
FATHER-LINK - The offset of the parent procedure of this sub- RL File Fornat 


routine. Since nore than one subroutine in a 
procedure can have the sane parameter and label 





Manes, the FATHER-LINK serves the sane purpose on | -on----ne- | | eo-ne-en- | 
a local level that the ID Nunber does globally. 0} LID [0 LORDER ID or | 
When conbined, the FATHER-LINK.ID NUMBER. OFFSET Jocoe-oe- =-| I { 
cortination provides definitive identifier 1] FL {1 FILE LENGTN (IN RECORDS) | RECORD | 
recognition. |roceeneno=| ' 90 | 
2| WS |2 WR. SECTIONS | | 
BROTHER-LINK - The offset of the subroutine preceding this one, [seseessees | Joor------- | 
(if any). ‘| \3 
SON-LINK - The offset of the first sutroutine (if any) in the 4| \4 
procedure or outer block. e SAXL te S.A. EXTERNAL SET LIST 
CLASS/TYPE + The identifier class and subclass (See SPL INS). orale socccocces 
1 
I - Set to 1 if a reference paraneter. | | | | 
| |7 |] FREE MAP | 
NODE/ADDRESS - The identifier addressing node & offset (See INS). ‘al i‘ 0 
nc - The nunber of characters in the identifier nane. +14 ‘3 Jooeeencen= | 
CHAR1..CHARNC - The identifier nane. | | 
12] 110 
SPL - RA value (currently 99) identifying the scurce | | 
lar.guage to Synbolic Debug. | | |onoenean--| 
| i NS | 
VALUE - See Diagran. | | | 
| | | FREE nap | 
LEVEL - See Diagran. | | } NS-1 | 
a ee 
| | NOTE: Uninitialized fields are 
| | reserved for future use and 
| | should be zero. ' 
| NS + 1] | 
| | j | 
| | | | 
| | | | 
| | JAVAILABLE | 
| | | | 
[-+-----<-= | | | 
ve Ag ha $.A. HASH LIST 0 | | 
| 
[essesesrse| | | 
2 | | | | 
| . | | | 
Stel ) | 
ks HL fag S.A. HASH LIST 94 | | 
| | 
[==+=+2e5-= | [-oeeennnn-| 
6.23.00 6.23.00 
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or. flanagenen 


Relocatable Object Code 


File space is nanaged in terns of 32 word blocks (4 blocks per 128 uord 


record). 


Free space (blocks) is accounted for in a bit nap, which is partitioned into 
records (2K blocks per section). AO indicates that a block is used, a 1 


indicates that 1t is free. 


File space is also partitioned into S12 record sections (64 max. sections, 
2K blocks per section, |! nap per section). The nunber of sections in a file 
is NS = (FL + 511) & LSR(9). The first NS records following record 0 (records 


1 to NS) are reserved for the section naps. 


A conplete file address uould have the following configuration: 


1 1 


1222222222233 


r1d9dddtt 
| 01234567890123456789012345678901 


| | SECTION | BLOCK 


File (word) Address 
Double Word 


6.23.00 
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Typical Directory Entry 


u | Nu CODE 


@ | esreeeeeoeoerveeseerce | 22288 OOS SO OCSSSSE 2OSEBESEO 


uo uP | CN 


™™ | 


PARM.1 


| 
j 
i 
| 
| 
S.A. INFO BLOCK . 
| 
| 
| 
| 
| 
| 


S - Secondary entry point bit - set if the entry 
point was originally a secondary entry point 


U - Uncallable bit - set af entry point is uncailable 


I - Privileged Mode bit - set if code 
nodule is to be run in S°IVILEGE NODE 


LC is (0:2)...tevel of Checking 
0 2 No cheching 
1 8 Check fer procedure type 
2 # Check for # paraneters 
3 # Check for parancter type 


WP is (2:6) is # parsneters 


CN- Character count 


| 
| DISPLEAT | 


Relocatable Object Code 


TH- Procedure Type (see Data Descriptors earlier in this chapter). 
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Relocatable Object Code 


Entry Point Directory 
|a-en---- |--ne---- |-------- | |-------- | 
| HL Jewesee >| LINK ae LINK rae 0 | 
|----0---| Jemmeemne fs feweseree} feweteeee 
| USEO | | used | | USEO | 


The directory is partitioned into 95 HASH LISTS (sane HASH function as USL); 
each HASH LIST is a linked list of records. 


Each record contains a successor link (record #) and a used space count. A 
link of 0 terminates a list. When a record is void of entries (USED=2), its 
space is returned to the free storage area. 











6.23.00 
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Relccatable Chject Code 
P 7] nfornati 
0 15 
senecccwesetecocceccocwcncocere| cocenene\ 
| NU IKFO | 
Mu CODE 
| # ENTRY POINTS | | 
ccorwercewcownccccccccncneense=| \ | 
| i | 
{ {| | 
{ CODE MODULE }> mc | 
| 1 | 
| 1 | | 
[oer es oy aera / | 
EXTN LINK | | 
| | | 
| orooeonee cocoweccocece=| | 
| TPDS | | 
| eoenn ne nnn none mnw nn en ew eennnwen | | 
| TSO8 | 
NUSDB ' wut 
| KERDER | { 
| eevee eno nnwwnnccn cn enennncwenn | | 
| | { 
| HERDER | | 
| | } 
|--- woccecnnenee| | 
j | 
( 
. | 
| 
: 3 | 
| | 
| | | 
| peemo nn nn nnn nn nnn nncnnnccecnnce | ] 
| | 
HERDER | | 
| | { 
| eeennnnnn nnn nnn cnecewcnencccoe= | | 
| “1 | | 
| / 


: 
| 
| 


All headere for the procedure are appended to the info block. The 
header sete (EXTERNAL LISTS) are linked by increasing file 
address; a link of 2177777777770 terninates the list. 
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Relocatable Cbject Code 


Headers 


1234 5 67 8 91011 12 13 14 1§ 


Relocatable Object Code 


CHEPTER 10 PREPARED OBJECT CODE 





Progran File Fornat 


| 
| | 
IF ju] Nu CODE " FLAGS |0 
cee 1| NS 1. NUNBER OF CODE SEGMENTS 
| S.A. INFO BLOCK | | ereewcensnnee | 
| 2] cs : GLOBAL SIZE (08 TO QI) IN WORDS 
Sect ec Socket eek stectooteeseansexeeceeeoseeeece | | eennn-------- 
| S.A. ENTRY | . SRG fi GLOBAL AREA RECORD # 
S28 BF OS 2S S8HBSES2EEE8 i EP EP ESD Eb EP OS Me HS HS TP Eh a Eb a DD aE aD aD ah ap aD aD aha | SS SO eu S2eeaneae 
| PBA | = SAS : SEGHENT SET RECORD # (ERCH SEG. STARTS IN NEW RECORD) 
[os [<2| <<] $< [ecesaseras=|senssescosessnsasarcec= Boo —“™sCsisiLOC PSSM er oerere 
: Juiz) | KC ! CHAR 1 | - ISS ° INITIAL STACK SIZE IN WORDS 
wo fon foe [on | poem newoewnloocecewecenewesemmerown ff tt trterrororn 
; | IOLS i: INITIAL OL SIZE IN WORDS 
| : : | 4 MAKO  |7 MAX. DATA SEGMENT SIZE (DL TO Z) IN WORDS 
| CHAR.NC ! ! 10| SRE hi ENTRY POINT LIST RECORD @ 
[emcee | coc cw cewnewnesnnn | enn cnnenwencenconwcroce [==-2<s9--5<-= 
pu | NP | CN ! mY SSEG [9 STARTING SEGNENT @ 
|----- | erecccceecorewcns | eoonconennenne ecwowosom ff tote tt ere rerrn 
| TN 12] SADR o PRIN. ENTRY PT PB RODRESS 
| PARH.1 | 131 SASTLYT [11 O08 AOR. OF STLT (-1 IF NO STLT) 
|roenn-- seen en encore er enns enn enen sn senenowecon =| | rommcoreeece -| (STLTSegnent Length Table) 
| ‘ 14] SRFLUT [12 O08 ADR. OF FLUT (-1 IF NO FLUT) 
| : | 15] SAX [13 EXTERNAL LIST RECORD # 
| PARM.NP | 16] SSTT 114 PRIN. ENTRY PT SST @ 
17| SATC {15 STARTING RODRESS OF TRAPCON’ 
F - Set if fatal error | eooeecerenne- 
 - Set if non-fatal error 201 SAPMAP |16 STARTING RECORD OF PRAP INFO 
S - Satisfied bit - set if EXTERNAL ig ef J rroworerowore 
satisfied within RL 21 SAST |17 STARTING RECORD OF SYMBOLIC ITEMS 
U - Uncallable bit | enoeeoneene-- 
I - Privileged bit 22] FLAGS2 (19 
module is to be run in PRIVILEGE MODE a i i ssi ess Jerre nono ocoren | 
LC is (0:2)...Level of Checking 23| CKSUN [19 TOTAL CHECKSUM OF ALL SEGHENTS 
O= No checking £20000 0 0 Jem ereme momma \ 
1 = Check for procedure type 24| 120 | 
2 2 Check for # paraneters _——— { 
3 = Check for paraneter type 25| {21 > Three uords reserved for MPE/XL. 
NP is (2:6) is # paraneters ey a 
CN- Character count 26) |22 | 
TN- Procedure Type (see Data Cescriptors earlier in this chapter). Isesceseceee=| 
All headers are the sane as in a USL except for the PCAL header. 
9- 39 6.23.00 
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Prepared Object Code Prepared Object Code 
Proaran File Forn A Flags 
| -oenneneennne| | 2345 6 7 8 §$ 10 11 12 13 14 15 
27] [23 NOTE: ALL UNUSED WORDS ARE RESERVED FOR {Jee --]--]--]--]--]--1--1--f--}--1--]--1--]--]-- 
| -oreeeeee w<en| FUTURE USE AND SHOULD BE SET 10 i Wiwiz let ot | IBAIIAIPAT =| «JARI = TOSTPHI 
| it ZERO. 1 leedeofeelonb-odeedoe lee lee l--1--1--1--1--1--1--1 
31| |25 F - Fatal error in progran 
ccceecnner ene | W - Non-fatal error in progran 
32| {26 Z - Zero unit DL area 
| -e-rneeeeenn=| P - Set if any SEG is privileged node (if not set nornal = 
33] ' io nonpriv node) 
cst | cst | 
* 0 1 i \ CAPABILITIES 
| i | / (8A) (7) BRTCH ACCESS 
Jo-----]------| >» CST RENAPPING RRRAY | 
cst | (IA) (8) INTERACTIVE ACCESS 
n 
lo [-[--|-e--00} / } (PR) (9) PRIVILEGED NODE 
IPis} Sto| \ | 
lt (kK ACCESS TO | 
|-]-|--------- it GENERAL < 
| . | RESOURCES | 
| : > SEGMENT DESCRIPTOR ARRAY | 
= : | (MR) (12) MULTIPLE RINS 
ae SL [OS] (14) EXTRA DATR SEGHENT 
fA 
A EN ee ee \ [PH}) (15) PROCESS KANOLING 


Ok a A A RE Se SS ee 


a 


P - PRIVILEGED MODE 

$ - Segnent STT fornat: 0 old fornat; 18 new (extended) fornat 
N= WS -f 

K = 28 « (NS 01)/2 

L = ((28 ¢ NS # (NS © 13/2 ¢ 127)/128) 128 
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Prepared Object Code Prepared Object Code 








Externaj List 
Flags2 
0 78 15 - - z 
| 1234 5 6 7 8 9 10 11 12 13 14 15 |---|---|-------- | 
| [oefoe doe le= oe lee dee Led -= lof -- bee dee dee bee tee] | JNC [| CHAR 1 | TYPICAL ENTRY | | | 
1 WK RESERVED | Jensen |-corenee | | | 
| |ae|es|osececcnesseeneensnennensnansnssnnsnenans | eo, | | | | 
| ’ | CHECK 0 } | 
T - Patch area existed in all code segnents { ; | { | | 
K - Checksun valid |oenenee |-------- | | { | 
CHAR NCI | ! ar &2 
| NR | | | { 
CST Renapping Array |-on---- | -------- 1 \ { { | 
| strw | SEG a | | 7 | \ 
seseaee Jennn----| | | | | 
Contains the last CST nunbers assigned to the segnents, indexed by segnent | ‘ 1} | | | 
nunber. When a progran file is prepared, the array 18 initialized to 0, | . | > WR | | | 
1...,N. This array is used to re-establish intra-progran linkage uhen the | . | | | | CHECK 3 
progran 1s loaded. | -ene--- | -------- 1 | | | | 
| stra | SEG W | | | ! | 
|-=|----|-------- Lf | | 
Seanent Descriptor Array juc] wPe{) OCHO | | | 
|-=|----|----==-- | v | | 
| TN | | | 
Contains the segnent length and a flag indicating if the segnent is to be | eoeoennoneneonne | v [ 
loaded in privileged node, indexed by segnent nunber. All segnents begin on | PARN 1 | { 
a record boundary. The nunber of records for a given segnent is (SL + | ewecowonenncwoee | | 
127)/128. The record nunber, SAS, of segnent N (0 <#N <#NS-1) is: | ! 
If H > 0 then | : | | 
FOR I= TO N-1 | oonwoenn enn nnne- | | 
BEGIN | | | 
SAS:2SAS + (SL(I) ¢ 127)/128 | poeocoeennenccen | { 
END | PARN NP | | 
ELSE | eeeeewenwonnnece v 
SAS: sSRS; . ‘ . 
Global Area Fornat | eooenne nr enceoee | 
0 | LIST TERMINATOR 
A set of records containing the initial set begins at record SRG (Word 3) and 
consists of (GS ¢ 127)/128 records. 
LC (0:2) = Level of Checking 
O >= No checking 
1 >= Check for procedure type 
2 >= Check for # paraneters 
3 >= Check for paraneter type 
WR © Nunber of References 
NP (2:6) = Nunber of Paraneters 
Parni...Parn MP 2 Contain Data Descriptors docunented 
: in Chapter 9, “Relocatable Object Code" 
6.23.00 6.23.00 
10- 4 10- 5 
Prepared Object Code Prepared Object Code 
fn Point Li Code Seqnent With Patch Ares 
|----|--2-|--------- |-nenwenneenn--—-| 
| | WC | CHARY | | | 
| ----] ---- | --------- | CODE | 
| i 1 { | 
: | | ----------------- | 
| : | | | 
| ccorceeee|onen--=--| | PATCH | 
| CHAR NC | | | AREA | 
|---------|--n----=-| | | 
P.B. ROR | ore 
| STT &@ | | STT | 
[ecrerceneeneneenen| | 
|-------------- ---| 
| -owefonn- | -oeennnne Patch Area 
| [we] CHAR. | 
Pelle | 
| ‘ | | PROGRAN |  4-WORD PROGRAN NARE 
poe | occas, 
| CHAR NC | | SEGHENT | 8-UORD SEGRENT NAME 
|-eeeeone-|--enere=n| KANE | 
| P.8. AOR | | pene nn nner ewencee| 
| onnnencecnecnnennn| | { 1-WORD UNUSED 
| sit | areca aS SRT | 
| -re-nnnn--neeenene- | CHECKSUN |  1-WORD CHECKSUN 
| 0 | LIST TERMINATOR seceereennseweaaas 
| erneewnwenoccenwnee | | PREP TIPE |  2-WORD PREP TINE 
| PATCH TIME | 2-WORD PATCH TINE 
NOTE: The entry point list nust innediately follow the external a ee 
list. PATCH | 
} AREA 
| PALEN 1-WORD PATCH AREA LENGTH 
| STT | 
[sasearaessesenes bad | 
6.23.00 6.23.00 
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Prepared Object Code 


PRAP_Infornation 


| S2e8ee2ee2ee000e0 | 


PTT PRAP TYPE TRBLE 


SEGHENT PARP POINTERS 


| 

| | 
| RPO ! ACTUAL PRAP DATURA 
| 

| | 


PHAP Type Table 

en | 

PTTL TYPE TABLE LENGTH 

! LPRO LENGTH OF PMAP RECORD TYPE 0 
LPR! LENGTH OF PAAP RECORD TYPE 4 
2 

= 

| LPRn | LENGTH OF PARP RECORD TYPE n 


NOTE: n ® PTTL - 2 


6.23.00 
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Prepared Object Code 
T ndary Entry PARP _R 
1144911 
9012345 


Priel ltsllt Fel et 
| | Ri | 


e 
e 


CHAR KC 


POSSESS £E282R0 | SeseoesoeoonseD 


ante ENTRY POINT 
ADDR 


NUMBER OF ENTRY. POINTS 


H = Hidden entry flag 
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cqmes 2 coments + —neree 9 DS SEED <> SED + am SERED - omtine 


Prepared Chject Code 


PRAP Records 


Type 0 Seqnent FAP Record 


111919141 
0123456789012345 
| Sei tet tlt Llet et 
| Oo | HAR 1 
|--------- |------- woe reoceceree | 
\ | 
| | 
| | 
| --eceeererne-n- | eon cocenenno-- | 
| CHAR NC ! 
| STT LEN | SEG NUN | 
| eawaneascoccses | cencacewscoscce 
| SEG LENGTH 
| SEGNUN | 


111111 
0123456789012345 

| “l-l-t-I-l-I-f-l-l-l-d-l-l-l-1-1 
} nc CHAR 1 | 

| -owenn--- |oreccee | eoeeneeoeennn | 

| ; | 

{ : | 

| ‘ | 

| penn -n enone nn na | -nnenernnn enon | 

| CHAR we | 

|= | -ewe nn nnn none | emo eene nnn ennen | 

|HI { 

| o | cemenn nnn nn en worn ce ennnnnnene | 

| SA OF CODE | 

| CODE LENGTH | 


| TOOL BOX PROCEDURE ID | 


6.23.00 
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SL File Fornat 
| 1111141 
| 89012345 
| Prtstefetslelel lll NOTE: LID = 4 - EXPRNDED SYSTEM SL 
0| 6 s 3 - ACCOUNT OR GROUP SL 
" FL f FILE LENGTH (IN RECORDS) 
al EL : EXTENT LENGTH (IN RECORDS) 
: {3 
4} NSEG 14 @ OF SEGHENTS 
5| 15 
| eo nn anne nnn nn-- een e ee nn enn eneee| 
6] : 
7| FRTL |? S.A. OF FREE R.T. ENTRY LIST 
oe | (-1 IF NONE) 
10] ti 
11 NRT 19 @ OF REFERENCE TABLE ENTRIES 
- 110 
131 NS 111% OF SECTIONS 
at NOT USED {12 
tae NOT USED \13 \ 
| 16] YCRR | AY OF YEAR \14 | 
| [eeeennnenenee |e | emccenncenceene | TIME RND 
Ma HOUR OF DRY | MINUTE OF HOURI1S r peer 
}20| SECONDS | TENTH OF 116 | ROOIFICATION 
| | SECONDS | | 
Jasscnesrcneas= [ococeccesernse= 1 / 
| cd = 
| 
41) HASH LIST 133 
eee aor 
aes a NOTE: Uninitialized fields are 
| reserved for future use and 
[cl PeterRtnncstessenseeseeses> won| should be zero. 
— 494 ha HL = Hash List. 
6.23.00 
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Prepared Odject Code 


For Group and Recount SL 


0 | ----n-s2--2--=== 


For Systen SL 


| 

| 

RECORD | 
_ 





oe Scenane 


sn 7 a “| 
| RECORD |<--REFERENCE =| RECORD { 
| 1 |  TABLE------ >| 1 | 
l | POINTERS | | 
oe --| \ [acenceeceeeenses | 

\ 
\ 

a socenwaeneen=e | \@lnronrenerenneene| 
| FREE RAP | | RECORD | 
{ 0 | | 2 | 
| | | | 
——o| |--an-oncnnnnnn-n=| 
| ! | | 

NS#1 |>rns-enneonneene| ao mwaaonsnna| 
FREE MRP | { FREE MAP | 

NS-1 | | 0 | 

| | 

| | 


HSe2 | ------ennnnn-ene 


LAST | --------n--==--- 
C | 

| 

| 


NS#2 | ----e--nonan=-—=| 


| 
FREE RAP WS-1 | 
AVAT LABLE | 


NS+3|------2-------=-| 


| AVAILABLE =| 


AVAILABLE 








NS = Munber of Sections 
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Typical Directory Entry 
012345 6 7 8 91011 12 13 1415 
J-o-=|--]--1--]------]--]--1-- | l--1-- 1-1-1 
| [ (UIXSIP |) = WC | CHAR 1 | 
| Jo~]-- | -- | --] ----n nnn = | -eennnnnn ene nne nnn nena | 
| | e { 
j | . | 
| | . { 
| | coneeceee sreewsccsesene |-coecnenencececonosenens | 
| CHAR NC | 
| | STT SEG @ 
{ | pone e [one nnnennnennnnn= | conn en enernnneoeeenenn=| 
| ju | NP | CN | 
| | ennee | -noennnn anon nncnn |ennwonrnennncnneenocene| 
| [ TN | 
| | 8 8 080828 SS8 08 C889 EO9G0S 288 OSGS8SSSSESE O89 2OSE SSTOST8SES } 
| | PARA 1 | 
| | S009 OSC 0809SO88OO9SE08 O46 CO SCSSRRSOSSSSHSSOSOTOCSS | 
i ot: 
| | . | 
| | 08 OOS SS 09984 SS5 294 GOSS S46 8SE SOSSSSSSSSSSTOHSEOSE | 
PARN NP | 


80090 6 080 OOO8 C0 0886888888888 0SE6 GOSS SOSEBOCOTOOS | 


LC is (0:2)... Level of Checking 


Q >s No checking 

1 >8 Check for precedure type 
2 >= Check for @ paraneters 

3 os Check for paraneter type 


WP ie (2:6) is @ pareneters 


P - 0 = Not pernanently allocated 


1 


2 Permanently allocated 


U - Uncallable bit - set if entry point is uncallable 


XS- The moat sxgnificant bit of segnent nunber 


20 


if « 


#1 if >9256 
NC- The nunber of characters in the entry point nane 


CN- Character count for paraneters 
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Prepared Object Code 


Storage Nanagenent 


File space is managed in terns of 128 word blocks (1 block per 128 word 
record) 


Free space (blocks) is accounted for in a bit nap, which is partitioned into 
records (2k blocks per section). 0 indicated that a block 18 used; a 1 
indicated that 1% is free. 


File space 18 also partitioned into 2048 record sections (16 naxanun sections 
for Group and Account Sis, 32 maxinun sections for the Systen SL; 2K blocks 
per section, one (1) nap per section). The nunber of sections in the file is 
NS = (FL ¢ 2047)/2048. The first NS records follouing records 0 and 1 for 
Group and Account SL (records 2 ¢ NS + 1) or following records 0, 1, 2 for 
Systen SL (records 3 to NS #2) are reserved for the section naps. 


If the section naps specify nore space than is potentially available, those 
records beyond FLINIT are marked as "USED". 


Entry Point Directory 


| 
| HL |------ >| LINK |-»---->| LINK =| -9---->| 


| | 
[| USED | | USED | | USED | 


Ihe directory is partiticned into 95 Hash Lists (sane HASH function as USL); 
each Hash List 1s a linked list of records. 


Each record contains a successor link (record #) and a used space count. A 
LINK of 0 terninates a list. When a record 18 void of entries (USED = 2), 
its space is returned to the free storage area. 


The Hash List head pointers (HL in the diagran above) are in record 0, uords 
z41 10 2177. 
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Prepared Object Code 
od nent Linka trusty 


| 
| 
CODE SEGRENT 
| 


| onanncncecewennnenrese 
{ 
| STT MAP RRRAY | 


Each code segnent occupies an integral nunber of records. This block of 
information can be subdivided into three tables: the CODE SEGHENT proper, an 
STT SEGNENY map array, and an EXTERNAL LIST. 


STT_ Map Array 


In the Systen SL, the STT Map Array is a 1 Uord X 256 Word array. In Group 
and Account SLs, it is a 1 byte x 256 byte array. It is indexed by STT 
nuvier. It contains the segnent nunber which has the entry point 
corresponding to the external of the STT nunber. If no entry point in the SL 
natcher the external, each bit in the Word (or byte) is set to one. This 
array is used ubenever the segnent is loaded and is updated whenever the SL 
as bound oy the Segnenter. 


External List 


A symbolic list of the EX'ERNALS of the segnent. Each entry contains 
information about the EXTERNAL: paraneter checking level and paraneter 
natchang infernation, and the segnent nunber and STT nunber if the EXTERMAL 
as satisfied within the SL. 
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Prepared Object Code 


ode 


eqnent Structure (Cont. 


141941 
0123456789012345 
l-l-}-f-l-}-f-T-l-L-l-}-1-1-t-t- 


COOE SEGHENT 


STT MAP ARRAY 
(SYSTEM SL=256 WORDS; 
GROUP/ACCOUNT=256 BYTES) 


| 
| 
| 
| l= lelel 
Ist Ixt | NC | CHAR (1) | S - SATISFIED SIT - SET IF EXTERNAL 
|-|-[-|-]-neneee| nnn nnee nee eo oe | IS SATISFIED WITHIN SL 
feo | %- 1 IF SEGH > 256 
| | NC - NUMBER CHARACTER IN EXTERNAL 
| | P = LEVEL OF CHECKING 
Jewenaeneranecen [esnosseara=nst= | QO >= NONE 
| CHAR WC | | 1 > PROCEDURE TYPE 
| --------o---ee= | enoreenceen none | 2 >s # PARAMETERS 
| sit | SEG. # | 3 >2 PARAMETER TYPE 
[-|-------2ee-- | -weenno-nonn=-- | NP - NUNBER OF PARAMETERS 
[Pj WP | CN | TW - 
|-|-onremenen ens | -- ene nennene ens | 
;  o™ | 
|oncecerecensorenecerwnnewennnes | 
{ —- PARM 1 | 
| -eonnwnnncewnnnnnnnewonenornnnn | 
| | 
| | 
|  PARM NP { 
| -owenenncwecnennnnennnnnennnnne| 
| : | 
0 | EXTERNAL LIST TERMINATOR 
6.23.00 
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Prepared Object Code 


Reference Table (510 Maxinun Entries 


01234 5 6 7 8 91011 12 13 14 15 


/ \ 
| i ul SEGHENT LENGTH io 
| 1]  SEGNENT ADDRESS (RECORD NO.) i" 
he OF ave SEG AND EXTERNAL LIST |2 
| | 3] FI SI } AL ci Xi INO. ENTRY POINTS |3 | 
| | Jon |on|onneenne bon doe oe leone leo enretnrnrrrrene } > Group 
| 4] STARTING ADDRESS OF PNAP 14 | and 
| [rece n nnn nen nn nn nnn n rence nenenscoeressenesesree | | Aecount 
| | oe ADORESS OF SYMBOLIC INFORMATION ‘i | 
! 4 TI KI | FOR meee | 
y SYMBOLIC INFO. LENGTH : 
110] SEGHENT NANE 18 | 
Systenc | j | 
| St ‘es tae 
120] REFERENCE SEGNENTS 116] 
i | BIT MAP (FOR BOTH SYSTEM SL 1 4 
1 | AND GROUP AND ACCOUNT) {| 
1371 \31] 
40] EXPANDED REFERENCED {32 
1] SEGNENTS BIT AAP | 
| | (FOR SYSTEM SL ONLY) | 
(571 \47 
| Joweeecenene won coeneenecccoccns conse nnornsecnes | 
| 160| \48 
RESERVED 
| |77| (63 
| \ [ewe nnn nnn nn nm nnn newer en enn ener nen re menroracere | 


Uhere: P21 if the code segnent contains a privaleged instructica. 
N=O 


if tne STT is in the ol¢ format. 
Nz1 if the ST7 is in the new format. 
Fe} if the segnent is deleted. 
S21 if all external are satisfied. 
Aci if the secnent is permanently allocated. 
=1 if the segnent is core resident segnent. 
X21 if the seqnent is an MPE segnent. 
T=1 if the segrent cortains a patch area. 
Kz1 if the seqnent centsins a checksun. 
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Prepared Object Code 
Reference Table Structu 


Each segnent has a corresponding Reference Table. 


- For Group and Account segnents, Reference Tables are packed four (4) 
entries to a record; each entry has a 32-uord length. To determine entry 
nunber and displacenent, davade segnent nunber by 4; renainder = R T REC 
entry nunber, quotient 2 displacenent into the Reference Table Pointer 
Nap, Record 1. 


- For Systen SL segnents, Reference Tables are packed tuo (2) entries to a 
record; each entry has a G4-uord length. To determine entry nunber and 
displacenent, divide segnent nunber by 2: renainder = R T REC entry 
nunber, quotient = displacenent into Reference Table Pointer fap, Records 
1 and 2. 


Uhen you delete a segnent, the corresponding Reference Table entry is 
released. Free entries are linked in a list. The segnent nunber (link) 15 
the first word of the entry 


Uhen you add a segnent, it is assigned the first free Reference Table entry 


nunber. The segnent is assigned the next available Reference Table entry and 
space is allocated for the new entry. 


Reference Table Pointer Map 


Group _or Account Systen_St 
DREC 1 RT REC ' R T REC 
j RL J-->} € |--> | OREC1 | RE j-->] € |--> 
| 0 | | o | | 
|---------- | [e-eeeeenee | | |--------=- | [eocennnne=| 
J}. } | € [ | bo & | | € | 
| | | 1 | | |-4===-—=- { | 1 | 
|. | |eeeenecen= | | | RLA2Z7 | [ereeeneaoe| 
| i | € | | o---- |---------- 
[i - 9 | | 2 | | OREC2 | RL128 | 
|n-cnnneen-| [oneeze=oe- | |------=--- 
| Re ; | € | | ; | 
{ 6 | | 3 | | |----------| 
Joceecennn=|  [ooeeneeee | ! RL 255 | 
(FILE REC1) (1 SECTOR) (1 SECTOR) 
6.23.00 
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Prepared Object Code 
Code Seqnent With Patch Area 

|-------------| 

| | 

| COOE | 

| | 

|-------------| 

| | 

PATCH AREA 

| | 

|----------———-| 

{ | 

| STT | 

| | 

|-------------| 
Patch Area 


| 
| SEGMENT NANE =| —-8-WORD SEGHENT NAME 


| | 1-WORD UNUSED 
a 
| PREP TINE | + 2-WORD PREP TINE 
| PATCH TIME | |  2-WORD PATCH TINE 
| PATCH AREA | 
[7 pauen | -NORO PATCH AMER LENGTH 
ene 
[| sit | 
featsee cette 
6.23.00 
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Prepared Object Code 


PAAP_Infornation 


|--an--enen-enno- | 

| | 

| PTT PAAP TYPE TABLE 
|---nwenneennnn- 

| 

i | 

| APD ACTURL PRAP DATUM 
| 

|-necnnenneenen| 


PMAP Type Table 


| 

| PTTL TYPE TABLE LENGTH 

| LPRO | LENGTH OF PRAP RECORD TYPE O 
| LPRI | LENGTH OF PRAP RECORD TYPE 1 


| LPRn | LENGTH OF PRAP RECORD TYPE n 


NOTE: n & PTTL - 2 
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Prepared Object Code 


T nda ntry PRAP R 


11721941 
012348§6789012345 
~l-l-I-l-f-l-l-l-l-}-l-}-1-l-l- 
2 |] we | CHAR 1 


| . | 
eeeoee S@oeaneannse | Coe a sae eeseeeaenu | 


CHAR WC | | 


a oa 
: | 
| SECONDARY ENTRY POINT | 
| ADDR | 
|---ceeenovernennnnnsernnar--=--| 


NUMSER OF ENTRY POIXTS 


O88 SOS SES2828 42604 BE SSB S SETH OHOOO 


H = HIDDEN ENTRY FLAG 
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PRIAP Records 


Type 0 Seqnent PRAP Record 


111111 
01234856789012345 


| I-l-lel-t-lel-t-t-t-l-leled-t-d-f 
o | wet CH 


| AR 1 | 
|oonneene- Jenene |oonenenneeen- | 
| | 
| ; | 
| ; | 
| cooceweoceeece~ | coceneennennene | 
| CHAR NC | | 
STT LEN | SEG NUN 
SEG LENGTH | 
16-827 SEG NUM | 


Type 1 Procedure PAP Record 


11171141 
0123456789012345 
lel-l-l-tel-l-f-t-l-t-t-i-1-1-t-1 
| 1 | we [| CHAR’ | 
| -eeeeennn | -neenn= |oonnneeanon--| 
| ‘ | 
| ‘ | 
| : | 
| peeweennnennewe | nme cceoconennse | 
| CHAR NCO 

|-|----- ereneeee | oo-neceenonenn=| 
{H] | 
| - | pomn ewe nnnnowewenenenerenenn= | 
| SA OF CODE ! 
CODE LENGTH | 
| PRIMARY ENTRY POINT ADDR | 
| COBOL TOOL BOX ID | 
| LINK | 
| 


| 
TOOL BOX PROCEDURE ID | 


| 89S O88 9080 0S 02288892868 S88SSS2SE88 
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CHAPTER 11 _LORDER 
NPE Loader 


The loader is a systen process uhich will do loads sequentially. If a 
process needs code to be loaded, it must use the RPE intrinsics or connands 
which will get the load process’ SIR, fill the loader connunication table, 
and then auaken the loader. Upon completion, the loader will return its 
status through the loader connunication table, and then the waiting process 
will be activated. 


Loader Seqnent Table Overview 


The Loader Segnent Table consists of at least tuo OSTs. The firet one is DST 
222 and is known as the LST. The others are known as LSTX data segnents and 
are linked together by a doubly linked list with the list head in the LST. 
SYSGLOB 2226 also points to the first LSTX in the chain. The following 
illustrates this structure: 


DST 222 J---ABS (21226) 


|-nn-nnn---] |a-------—-| |----------| 
| | | | | | | 
| st |cnom-->}  LSTX  ewnnnn>] STN [ceeenem>] LSTX { 
| | i | | | | | 
| | |eonen-=-e=| | ---------~| [oo--oeo-==| 


The prinary purpose of the LST/LSTX data segnent is to store directory 
entries, uhich keep track of loaded code segrents in progran and SL files. 
The LST data segnent contains an additional area, knoun as the Loader 
Connunication Table, through which all processes in the systen connunicate 
with the Loader process. flanagerent of the messages in this area is handled 
exclusively by privileged systen cede. 


The overall layouts of the LST and LSTK data segnents are as follous: 
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Loader 
LST Overview 
| penne nnewennoennoeenn= <-| 
. ! 
* PRIMARY OB AREA : 
| | 
| | 
| eoron enon nner enn eennonnn= { 
DB+2 -->/ ] 
7 COMMUNICATION ~ 
| TAB | 
0B+7 -->| ! 
- SBUF (128 WOROS) 7 
| | 
| pone ewe cer nnnnnconenecocs | 
DEO -->| 
~ DIRECTORY 
| | 
2| | 
| cocewee nnn secmnwenensccce | 
KLST Overview 
 Kacetecennetetetechatattecenatatenetatetaneieta | 
" | 
a PRIMARY OB AREA : 
| | 
feostigussso euch eeees | 
DB+7 -->] | 
~ SBUF (128 WORDS) : 
| | 
| ponenewn conn coeneennnnnne| 
DB+0 = | 
~ DIRECTORY 7 
| | 
2| | 
| coen none nn none reeeerenne=| 
6.23.00 
{1-2 
Loader 
ader vient Table Prina 
eevessucesonccesea | weecccccooconcce 
| 9 @orr : 24|HDFULINK(TYPE 0) |/20 
} 1 DIR LEN {1 Sere mie 
| 2] @uT 2 | ; | 
3] ENTP ik el poco eecaeeses| 
wocccccconccccce| 34 |HDFULINK(TYPE 8) (28 
4) ENTP1 164 fem eee wceenesee 


5| ENTP2 15 
6| ENTP3 16 


i 7| @seuF =? 
i Is 

ar 

ee se 110 
a ae i 
14] sn mae 112 
\ ae ae 13 
‘Cr ae ee 14 
ae ee 15 
er eee 
lee ee 17 
Labs 
lalo6st).O 19 


35|HDBXLINK(TYPE 0)|29 


Sear ere me 


4S|HOSKLINK(TYPE 8)|37 


46/S| LOADER | 38 
{Al AUX OS | 


|- 28 Seeeean eee ee 
47 |REFTAB OST# 135 


ENTPn = Pointers point to the current accessed entry 


SBUF = Utality buffer. Usually contains progran file record 


0 information 


SI ~ ST 2 Utility CB relative variables 

$A = Giobal evsten uide AUTOALLOCATE ON/OFF flag. 
HDFULINKs = Head of forward link for each type 
HEBKLINKs <= Head of Gackuard link for each type 


REFiaB cSt: DST renoer for tre DST uhach contains all the reference 


table entries for SL.PUB.SYS. 
6.23.00 
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Loader 


The layouts of the Prinary 0B areas in LST and LSTX data segnents are 
identical. However, only those words required for nanagenent of the 
directory area are maintained in LSTX data segnents. All other prinary 08 
cells are defined only for the LST data segnent. 


The purpose of the LSTXs is to provide relatively unlinited storage for the 
LST directory data structure. For perfornance (and inplenentation) reasons, 
only those entry types related to LOADPROC functions reside in LSTK data 
segnents. When these entries need to be accessed, they are copied into 
tenporary entries in the directory of the LST cata segnent. In order to be 
sure that this 16 possible, a naxinun-sized entry of each LOADPROC entry type 
(LORDPROCNASTER and EXTENSION) 1s reserved in the LST data segnent by the 
Loader process. Pointers to these special reserved entries are stored in the 
Prinary 08 area of the LST data segnent. If one of these pointers is zero, 
it neans the Loader process was unable to allocate a naxinun-sized entry, in 
which case a dynamically allocated entry of the required size nust be 
allocated for the copy of the needed LSTX entry. 


The first word of each permanently allocated, tenporary entry 18 used to 
indicate whether or not the entry is currently in use. Zero means it’s 
available; anything else neans it’s already being used to access an LSTX 
entry. Existing loader logic should not require access to nore than one LSTX 
entry of a given type at a tine. 


In order to prevent tenporary entries fron accunulating in the LST data 
segnent’s directory, they must be explicitly removed (copied back to the LSTX 
data segnent first, if nodified) when no longer needed. This differs fron 
LST-data-segnent-resident entries, which require no special logic in the 
accessing code tc release such entries. And this, in turn, 18 uhat nakes 
moving entries fron the LST to the LSTX so difficult; it’s sonetines hard to 
tell exactly when an entry is no longer needed, and, therefore, is safe to 
release. 
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Loader 


A reference table entry in SL.PUB.SYS is 64 words long (however, only the 
firet 48 words are used). The data segnent only contains the 48 words of the 
entry which are used so a6 to not waste space. 


irect ntries 


This section shows the layouts of all LST directory entry types. The layouts 
given are those for permanent entries in the LST or LSTX. For tenporary 
entries (i.e., those entries in the LST data segnent which are copies of 
entries which reside in an LSTX data segnent), the following three-word 
prefix should be attached: 


| 01234 5 6 7 8 §$ 10 11 $2 13 14 15 
|n=|==|==|-=|==]-=[=-1-=1--l-=foef--b--1--t-- l= 


| HOME LSTX OST # 


| 
| HONE ENTRY LENGTH | 


BES OS OS © @ 99S 02S 4 © © 828246 8298S 2ETS 9S 26 2229SEE2632 | 


ENTP in the Prinary D8 area aluays points to the word after the LENGTH uord 
of the entry currently being accessed. ENTPn pointers are used to access 
other structures within the current entry. The first three uords of 
permanent entries (or firet six words of tenporary entries) define the entry 
header words, and are negatively addressed through ENTP. 


| 01234 85 6 7 8 91011 12 13 14 1§ 
Jon |o-loe foe fee on fo-|--]--]e=]--]--]--f--|--l--]  GARBAGE(O) 
0] FORWARD LINK | 


| " BACKWARD LINK | 
eSwdedcncoseon seoeeecs dc oc eecostisewss céeeceseseuwss | 
| 2] LENGTH | | 
sadesvcedadcoosscscicnee Sec bccaoccecenSacuacesos | 
1 3 | 0 ! 
| 4] GARBAGE | 
| penn nnn nnn wenn nnn nen enn as - come e nnn en nen eonnne e+ | 
6.23.00 
"1- § 





Loader Loader 


























ntri f irecto ntries (Cont. 
| 041234 5 6 7 8 9 10 11 12 13 14 15 | 01234 5 67 8 9 10 11 12 13 14 15 
|--|--1--|--f--f--1--l-edee tee den deeleeleoleet--1 SL FILE(1) J--|--J--[--]-- eben dood o- bee l-nt--teeteel--t--] | PROGRAR 
‘| FORUARD LINK | i FORWARD LINK ! FILE (2) 
| 1) SRCKUARD LINK | [ BACKWARD LINK 
| wecwawcucwcwecowewnmecwocowwccensocccasceszeoes$ 0 t i (J PR CSP eer oreo cesses onnwouncowanownnaneoecre” 
| 2] LENGTH ; | 2 ae 
| emcce| ool ecccecewwnccca | ancccccnmewwmeresoeoewef— 0 00 iE fot foe Peeper erore reese | coewsosonoencuennnnsecs 
| 3| het | 1 | | ae . ee 18 | 2 
| FILE DISC RODRESS | " FILE DISC ADORESS | 
[ 2 . a 2 
- | 4 3 
{ FILE PV INFO | . CST BLOCK INDEX 
| y a ALLOCATED SEGHENTS | | 7] SEGHAP DST 
| ba # SEGLIST ENTRIES | | as W PROCESS SHARING | 
| 11 SEG ARRAY (32 “ORO IF XS 2 1) | 1 11] # SEG IN PROGRAN | # SLINFO RREA | 
| | (16 WORD IF XS = 0) sepia | ! FILE | ! 
OSS 28280 2S289 2408422424640 268 €OE 6S | 222884688 [ Oe [vai ae [ee \ SSS OS OOS SE OSS SSSSHAVSSESNES | OF OSOSSE © SBOSFEHMV*SDBEABDSBECOE 
| | LOGICAL SEGHENT NUNBER | APC) xi ml | 12) PV FILE INFO | 
1 | woe cwccnerercesseconecen@ [soseea5= f--|--]e-]--] | SEGLIST ARRAY | cone nor ewc cer ccenwennnensenewnccesooesoreccooce | 
| REFERENCE COUNT | > 3 WORD ENTRY | 13] TRACE EXTERNAL PLABEL | 
=== enanncnornnencocnsccncnwotecccennncenen| | PER ALLOCATED | wa | enone nnenn wenn neneweenneereweeceecnnonnnnnn=| \ 
| PHYSICAL CST NUNBER } SL SEG | ae | SL SEARCH SEQUENCE | 
i ‘ : ie SL FILE DISC ADDRESS b | SL INFO AREA 
|-----scceen-- encceeeee wecennnnnennacneecenee o--| | 16| | > 35 WORDS FOR 
| |  etecatateepetaetatettatettaal wecccwwnonerccccewnnecenenees | | SYSTEM SL 
| cocccecown nnn nneceeesnne wecnewccrcccnecocen coee| } 17] | | 19 WORDS FOR 
| | ” LIB SEG ARRAY (16 WORDS) ~ | GROUP AND 
| eoencwnnnennnen anne nn nennnnen nn neenncerenneecee | . ~ | RCCOUNT SL 
| | | ennnnnnnn nnn nee nnnnnn were nennne nnn nnennnnnncoe| / 
| ---nannenerennencenennnncnncennnnenenenensnnnne | ee I 
Uhere XS = 1 means entry is for the Extended Systen SL bit nap ie : 3 
of 32 words. | powwow wenrren cower sewer enenneccowccosonneneoce= I \ 
A = 1 means code segnent is allocated. | PSEGHAP SIZE 1 | 
C = 1 means code segnent 18 core resident. HEE (eoeteteoatatetetetetaiatenenneneneneneeaneant | pron ceweenennnnnene 1 | 
Xs 1 means code segnent 18 an NPE systen segnent. | } (TB LOG SEG (9 BITS) | SL INFO INDEX 1 
NM = 1 means code segnent is physically napped. | | coon n enn nroce nonce eencenee  Rececetatattetatetetetetatetetatetetaten | | PSEGHAP 
2 0 means code segnent is logically napped. | (LIB LOG SEG (9 BITS) SL INFO INDEX | ARRAY 
} * . * | 
| l | 
| UB L0G SEG (9 arts) | SL INFO INDEX | | 
6.23.00 6.23.00 
11- 6 W- 7 
Loader Loader 
i ory Entri n i ntrie fn 
Uhere P = 1 means progran is executed with NOPRIV cpticn. | 0123 4 § 6 7 8 9 10 11 12 13 14 15 
A= 1 and AA = 0 means progran is allocated. Jo=foe fon f-- lee] lend leo fenton l--l--l--1--1--1  LORDED(5) 
RA = 1 and A = 1 means progran is auto allocated. | Of FORURRD LINK | 
XS = 1 means entry contains an Extended Systen SL bit nap | ewe ennn een n enn nnn enwnewwcecnccewnnnnnncecenece=| 
of 32 words. | 1] BACKWARD LINK | 
$ = 1 neans this bit nap is for the Extended Systen SL and | oon nn even wen ener nn wwnnenesennswcccsoncocwnnes | 
contains 32 words. { 2i ra ! 
1 3] | | § | 
| 0123 4 85 6 7 8 9 10 11 12 13 14 15 co | ccoeeeeee woe | ewecwenenconnenon enone e| 
|--|--]----|--}--l--1--1--l--le-b--1--T-eb--}--} WADING(3) | 4] FILE OISC RDORESS | 
| Of FORWARO LINK : | | - -| 
Sec seeeeesreeses eeeewenecccecnccenecconenecones| ' 5! | 
} 1 BACKWARD LINK | | eoccwen nnn een meno wc wenocnwwencocorocnnneonenee| 
we ee ewe e cnn nnn en nenenenencccoronecocecsccccenes | | 6] LORD PROCESS STATUS | 
} 2] LENGTH { | |e -| 
n= [nnecncneccnanncnnens|aencnaennnnnnnnneeeenn=| | 7 | 
| 31 | 13 | |------------=-- wanneeenenn =o | 
| 4] PILE DISC ADDRESS { 
| le -| I 0123 4 5 6 7? 8 91011 12 13 1415 
| SI l |nafoe|oo lon faofe-teofend=-le-lool-el--l--l--l--] SHRRER(6) 
|----- seen wrerennneensseeesesce wrecwenaceoccen-=| | O| FORWARD LINK 
| 1) SACKWARD LINK 
| 0123 4 5 6 7 8 9 10 11 12 13 14 15 | 2] LENGTH | 
|n-|--Jo-]--f--]-eb--]--1--l--d--I-e len f-eles1--] RAITER(4) |--|------ ercee | emoe enn cene nee anneosen=| 
| | FORWARD LINK : | me 6 
| 1] GRCKMARD LINK | 4] PIN 
| 2 LENGTH ' | 1 FILE DISC RODRESS | 
}  3IP | 1 4 | 1 6] | 
[oo | roe wor wen coenwoceene | enn ener meennne-coecnnen | | prone emnnn nn nnnnmn www nn newecnecenemnnnnweeenone| 
| FILE DISC ADDRESS | 
4 | 
| z WRITING PIN ! 
| 7] UNUSED | 
a daa hc aaa ] 
6.23.00 6.23.00 
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Loader Loader 




















Directo ntri nt Directory Entries (Cont. 
0123485 67 8 9 10 11 12 13 14 15 | 01234 5 67 8 910 11 12 13 14 15 
Dep edettecdecdecle= lon decteel==feel--L-=1_ EXTENSTON(?) ee ee ee ed ee ed dd de 
©} FORWARD LINK | ©] FORWARD LINK RASTER(8) 
} 1] BRCKWARD LINK ! : BACKWARD LINK ! 
H pints Cee Ol escueeeteaetuceeteceeeaseeeh 2222 Is RRR Serer cee yee oak ere ree 
) 2] LENGTH : LENGTH ! 
saowe | oo J-- ecccecccecs | cncmwwcocowoocoe cocscce eve ccweececconceseccone | wcccocensavoscosccoesse 
| 7 Hes LIB ? | 8 
} 4] PIN | Word contains | 4{ PIN | 
waerwnernnnewennnecennnecenennrnececeeeennnenn=| — LOADPROC count, |oroncerenneeeereennonn= [eeiebieeetesacunsosa- Soe | 
| S| EXTENSION IO | if entry was | Si # SLID ENTRIES | # ACTIVE LORDPROCS =| 
| penne nnn enn nnn nnn een enn ree nnw nnn o nw eceenennnre= I\ created by | eno nnn nnn nennenn nn nnnn-  etatetatatattattaatatatatetatenetatetaae | 
| 6] LOADPROC COUNT(LORDPROC) / || LOROPROC. | 6] l 
| LOG SEG # (ALLOCATEPROC) |/ Word contains EXT IOX TABLE (16 WORDS) : 
| -en nnn n nnn meme w nnn nn nnn nen cenn een enenewenennene } legical segnent | 2 
| 7] PLABEL | nunber, if entry [aeestetnnsessonsssesennonHaesesesesosateennaes= | 
| peewee nnnnnenn new enennn | en nen enon ene nce nero nene | was created by | 261 i) 
| 10] @ CHAR IN NARE | ALLOCATEPROC. ses NCST IDX TABLE (16 WORDS) - 
| cones conesecocncnnonarce 
~ PROCEDURE NANE 7 [epece scacneeesresaricereia es ceeee ete on 1 \ 
S ° | 46) SLIO(1 | 
| wre en nwo nn wenn en enonnne | oon ne none -o none reececes | DISC RODRESS OF SL 1 | 
| | @ SL INFO RREA | | ern nn nnn enc ccwewn nnn seoncoowownorereressesance 1 | 
[oo | eoneceeenne wreeccene | concn cece ennnnennenones i\ | . | | REFERENCED 
1S | St SEARCH SEQUENCE | | SL INFO AREA =. ~ >» SL ARRAY 
| po] nnn nn nn een wen nwe nnn nncennnnnnccccncennnee| | 35 WORDS FOR a ‘ | 2 WORDS 
| SL FILE DISC ADDRESS | | SYSTEM St | eronn ono eencnn nnn reson nennnn cee nncccwewnnowoson | | PER ENTRY 
| | | 19 WOROS FOR | SLID(n) 1 
| | | GROUP AND | erce cow cen ee nececesnncn | monn enn ewenconensocscce | / 
| ten enewewnnrewencennccnceccwcenencesoncocencco=| | ACCOUNT SL | { @ ACST LOGSEG SIZE | 
| LIB SEG ARRAY (32 WORD IF $ = 1) 1 | | ewocee nn nnewensncowccee [eseenssnessessesssses- | 
(16 WORD IF $ = 0) ie | iz 
MCSTREF SIZE \ | LIB LOG SEG (9 BITS) | SL INFO INDEX ! | 
wy | MCST INDEX (1) | | REFERENCE COUNT | | 
i < ” » fICSTREF ARRAY | - | | ACST LOGSEG 
a: te -| - * * > ARRAY 
| po | ponnn nnn nnn wn wcewcne | eo wnewconneenscoccccen=| | “ “ | 2 WORDS PER 
jn | | MCST INDEX(n) 1/ | eoeceereetenweenos ence | coeccecene cen eceneonnne | | ENTRY 
| -- | -wocecneeccewenen wns | -coccconconwencececonnna| | LOG SEG W | SLIO INDEX(n) | ! 
XS = 1 means entry contains an Extended Systen SL bit nap | REFERENCE COUNT | 
of 32 uords. | eoocccene nn noncncnwerweesenccouconocccesooroone l/ 
$0 = Search Donain 
= 1 neans use progran group and account for library search. 
s 0 means use log on group and account for library search. 
$ © 1 neans this bit nap is for the Extended Systen SL and 
contains 32 uords. 
6.23.00 6.23.00 
11- 10 We 11 
Loader Loader 
Loader Cache Loader Connunication Table (UCT) 
SYSGLOB extension area ¢ X72 contains DST nunber of cache Forn Inconing to Loader (Load/Allocate Proqran 
BUCKETSIZE = 252 
che Dat nt F | 0123 4 5 6 7 8 910 11 12 13 14 15 
[-=|--|==1-=1--1-=]--1-=|--1--I--1--1-= l-= 1-1] 
|--= coccccocere| O| ChO | LIB | AULD} LI | 
0] | senna | evens | --|-2=5 | == [assesses reeesessesses= | 
HIT COUNTER {| , 
2] 2| UDEV | | 
3] MISS COUNTER | | come nn nncecener en neceee { { 
| peewnewnnnwecwncwnncncne| 3] OISC ADDRESS | CHO = loader cnd 
4] BUCKET 0 | | pee ene nnn co nnen nnn nn nwe enn ennseeneweworcs coneee| 0 = load prgn 
|-~e-oeoe- cccecencerenn =| 4| | 1 = load proc 
4¢ BUCKETSIZE | BUCKET 1 | | | 2 alloc prog 
| eooreeennn en eeor enna onn| 5| | 3 = alloc proc 
| : | | | L18 = library search 
2 . is 6] | 0 = SYS 
2 e = | | 1 s PUB 
fleeraes | 7] UNUSED | 2 = GROUP 
4094" BUCKETSIZE | { | | = NON PRIV MODE 
| BUCKET 94 { | 10] | LD = LOAD DOMAIN (FOR 
4+95* BUCKETSIZE -1 | | | | LORDPROC) 
\- 1 } 11] | © eUSE LOGON GAP 
| | & ACCT Sts 
— a Peet 
weeFoma®. 0 8 eR See secsesme ne eneeaseteeetcseesersnssr Ss ae Ls WH 
| 13] WAITER PCB INDEX | THE PROGRAN 
| -onnownnene-----| wcowscecnenencrocece | oo |-~|--|-----|--|--[--f--] RESIDES 
Oj LENGTH OF | : | 14] [BAI IAIPHI [MR] = JOS(PH[ USER CAPABILITY 
b SIN 1] | aaa a i) 
1] SLOIR 1 | MOST RECENTLY REFERENCED SYSTER SL | 
Jonenenewoenccoee| DIRECTORY ENTRY FROM THIS SL OIRECTORY | 16] GROUP | 
| LENGTH OF | BUCKET | [ 
| SLDIR2 « 1 } | ua NANE | 
! SLDIR 2 SECOND MOST RECENTLY REFERENCED ENTRY | = | 
a : z | a 
| ereeeneneceneone | 22] ACCOUNT | 
| LENGTH OF | | | 
{| SUDIRN + 1 | | 23| NAME | 
| -wneneeennn w----| Nth MOST RECENTLY REFERENCED ENTRY; IF | | 
BUCKET| SLDIRN | NOT COMPLETE THEN INDICATES END OF | 24 | 
SIZE-1 | ----eeeeeneenen~| BUCKET | oo = enn nn een e comm wenn nme ne nnn nnn nnn cnsncenennnen | 
| 25] ov INEO | 
All bucket words are initialized to BUCKETSIZE + 1, indicating J ons pene n nnn nne + con nen mo enn rnc esececescnnnceece= | 
no entries. 
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Loader 
ader Connunication T T nt. 


Forn Inconing t ader (Load/Allocate Proced 


| 0 1 345 6 7 8 9 10 11 12 13 14 15 
ig pa et ee gg ed es Ee Dd de 


0] CAD | LIB | MILD! LI 


| eseoeoe | seeuee | oe |-- | eo | oo | 28988 SOOO SOSCOZBEOBZHE8 | 


1| PIN 
| 


| 
ChD = loader end 
0 = load prgn 


| 
| | 
4| | 1 = load pree 
| | 2 ® alloe prog 
5] | 3 2 alloc prec 
{ | t18 = library search 
6| PROCEDURE NARE | 0 = SYS 
| | 1 = PUB 
a 2 = GROUP 
| ie | 
} 1 | t * NONPRIV MODE 
| | UD = LORD CONAIN 
| | ! L = LOAD MAP REQ. 
| a UAITER PCB INDEX ae Int 
| 14] jeA| IAlPn| {MR} = JOSIPH| USER CAPABILITY 
| ennnncennnnccennecree|oo|--|--]|--2--|--|--|--|--| 
| a 
| " GROUP 
| m0 NANE 
| 2| | 
| eneceecccenwee wae enewnencnncoceeneoccccnencenn=| 
| ay | 
| ei ACCOUNT 
| a NAME 
| a 
| 25] PV INFO | 
|--ceceeenneennnnnnanenenennemnnnnnnnnmecwnnnna=| 
6.23.00 
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Loader 


hoaical Seanent Transform Table (LSTT) (Cont) 








| # OF LOGICAL SEGHENTS ! 
| LENGTH OF LSTT | 
| PHYSICAL SEGHENT @ a 
buecusnwe Sengnecsees -| | LOGICAL SEG 1 
= | POINTER TO STT LIST lv 
| | PHYSICAL SEGHENT @ i= 
| | ewwweneemccercccnceccccocncenne=| | LOGICAL SEG 2 
| POINTER TO STT LIST | v 
; | ‘ 1° 
i | : : 
ieee | 
| | PHYSICAL SEGHENT @ (* 
a Coenen ecccecnneccccce-| | LOGICAL SEG hn 
Jia | oe TO STT LIST j v (MAX 255) 
i; int sire | SEG ® Mae 
| = |----- wecccees |ennnnnowneneeeee| | STT’S FOR LOGICAL 
| nj] site | SEG ® | v SEGHENT 1 
o | S2SS82O08S80R | 20e2eeeee eeeeoeese ( If NEEDED) 
1 foo. | 
1 | -[------- eeowne | eonceeennnnnnene| 
int SIT @ | séoa 
\-> TOTAL STT’S FOR THIS SEG 
| ~ 


| e2e2eeeeo' SOEEeee | 222222 Se2eeeueee 


STT @ | S&C @ 


STT @ | SG @ 


STT’S FOR LOGICAL 
SEGHENT n 
(IF NEEDED) 


. 
€e 


2288828 8SOCOGO@ | C8222 2S COOTESTFO 


-| 
" STT @ | SEG ® 
TOTAL SST°S FOR THIS SEG 


PDD DS PSD 


oO ee es ee ee ee wn we we er eer ew eee 


wv 


Cece es ew ee > 
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Loader 


Loader Connungcation Table (UCT) (Cont.) 
Forn Returned (No Error) 


ol tie] Sanne seen wath 
0 
2] WA MAPFUGSt*=~<“C=*C=‘“—~*~*~*~*~*~*~™S 
0 °° ©) ©). | 
‘ive es 
5] ADDRESS : 


| 
i} TRACE LABEL (IF TRACE) ! 


Forn Returned (Error Occurred 


1 
O| FILE SYSTEM ERROR # | 


| 
‘ LOADER ERROR # 


Logical nent Transforn Tabi STT 


When a process references any user SL segnents, these segnents are assigned 
logical segnent nunbers if the new mapping ucode is running. The LSTT 
provides a nap napping these logical segnents into their physical segnent 
nunbers and having true STT’s for the mapped segrents. The LSTT 18 created by 
LORDER during the load tine. It occupies an OST and the DST nunber is stored 
in PCB(Z17). If no user SL segnent is referenced, the LSTT will not be 
needed, hence it will not be created. 

The new napping microcode depends on the existence of the LSTT for getting 
the physical segnent nunber for a mapped segnent. So the LSTT has to be 
included in process’ locality list if there is an LSTT. Dispatcher will then 
bring the LSTT in before the process can be run. Also the bank and address 
for the LSTT belonging to the current running process are stored in sysgleb 
cells (%221 and 2222) during the launch tine by the dispatcher. These cells 
are used by nicrocode for fast accessing the LSTT. 


6.23.00 
11- 15 


Loader 


r_Ruxi ata Segqren 
Vervi gu 
The loader auxiliary data segrent is a multi-table data segrent. Each table 
within the data segnent has a standard header and they are linked together 
via 08 relative pointers. 
Tables within the loader auxiliary data segnent are the: 


1. Rutoallocate tadle 
2. Progran nane table. 


Loader Ruxijiary Data Seqnent Fornat 


{ \ 

\ °| TABLE SIZE 

| i ENTRY LENGTH | 

i TOTAL RUNBER FREE ! | 

} 3] FIRST FREE 1 | 

Table --| |------- eo anecsncsnree weer ewecnerecce oo-| | 

Header | 4] 08 RELATIVE POINTER TO TRBLE THO 06 | 
| [-eevenwewnwcnnncwnncnnennnensnennnnnnn=|  |-- Table one 

| | UNUSED ! 

é| UNUSED | 

\ 7] UNUSED | 

| -won ene n wwe remwennnnncncecwcreccccernne| | 

| 1 | 

RUTOALLOCATE TABLE 

| i | 

| 1 / 

(etter niet atetatetatatetatatatancanienentatanenenatentata 1 \ 

(| TABLE SIZE a 

| " ENTRY LENGTH 

} 2] uNlseo 1 | 

| [eronne nnn nce cm ncn en ence woeneen en snnsone 1 | 

| 3] UNUSED i | 

Table --| |------------ wewnececeseanenccorensecee= it 

Header | 4] OB RELATIVE POINTER TO NEXT TABLE ! | 


6.23.00 
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Loader Loader 


ader Ruxilia ata Seqnent Fornat nt. Progran Nane Table 
| - lesaeesseenaasesemoneercornseesserseon --| |-- Table tuo Overview 
| 5) UNUSED a 
| enon cen ncccn ene neer noe cnewnnconnownoce The progran nane table contains the fully qualified file nanes and the disc 
| 6] UNUSEO address of all prograns currently loaded in the systen. The nane of a 
[) [Semeeresssrsaesesnnseserntsesscsesese= progran can be found by indexing into the progran nane table with the sane 
\? UNUSED index used for the CSTX block table. This andex can be found in the PCB and 

Sheeasersseescesanaa ase sss ense tess rees in the progran entry of the LST. 





When a progran is loaded, its nane is entered into this progran nane table. 
However, when it is unloaded, it is not removed. Thus the progran nane table 
entry "x" will contain the nane of the progran which is currently allocated 
to the corresponding CSTX block index. If the corresponding CSTX block 
index is free then the contents of the progran nane table is the progran 
which was last allocated to that index. — 


{ 
i | 
i | 
' | 
1 | 
1 | 
{ | 
14 
ly 
1 | 
i 
| | 
1 | 
i / 


NOTE: Entry 0 of the progran nane table is used by the loader as a 
scratch area since there is no legal CSTX block index of zero. 


Autoallocate Table 








| | 
Overview | " : 
| 1]  PROGRAN \1 
The autoallocate table is a table to aid in the autonatic allocaticn/ | | 
deallocation of prograns. It is a least recently used list of prograns which | 2| = -NANE |2 
are not being used at the nonent and thus are candidates to be autonatically | | 
dealiccated. | : : 
| 4| 14 
n nten | | 
| PROGRAN : 
Each entry is a 08 relative address of a progran file entry in the loader | 6| GROUP |6 
segnent table (LST). | | 
| t 
Rutoal locate Table | os : 
| PROGRAM ’ 
O| LEAST RECENTLY USED ENTRY | | ie RCCOUNT fh 
| | | 13| [11 
; | |---------a--nennnnnnneeonnnnnne -—-----| 
l . | | 14| FILE [12 
| oISC | 
| ‘ | a RODRESS i 
| ewnnnnnnenernnannn-wasesennncncrcnncnses| | 16{ UNUSED j14 
| OST RECENTLY USED ENTRY | | prone nnn meen nnn mmo ne nnwowenennenee | 
aoccn co cerncnceecncwcocorccoconeccesco=| | 1?| (15 
|---nnnnonennnneennnnnnnnennnmnnnnnnnnnn | 
6.23.00 6.23.00 
11- 18 1f- 19 
Private Volunes/Serial Dise Private Volunes/Serial Disc 
HAPTER 12 PRIVATE VOLUMES / SEPIAL DISC Mounted Volune Table (MVTRB nt. 
iS CYCLI DIRCSIZE/32 i 1 
DST = 53 = 765 1] HVOL | WVOL | 1 | 
SIR = 2? 3 233 |oeweeee |coreree | cocmeennweenene | | 
2| LDEV | DIRBASE [2 MASTER VOLUME | 
1919999 eer mmonnoenne | {| OF VOLUME SET | 
01234567839012345 3| OF VOLUME SET 13 IS ON THIS LEV | 
[-l-t-1-1-}-1-1-1-1-1-1-1-1-1-1-I --- nonnnnennanenneneneennnnecennne| | 
O] ENTRY SIZE | MAX ENTRIES [0 ; 4| UCNT : 
1] @ OF MOUNTED VOLUME SETS 11 ! | eee Is \ | 
2] LDEV | DIRBASE [2 MASTER VOLUME OF | 6[ LDEV | VTABX 16 | | 
| enrecenneneenene| -] SYS VS IS ALURYS| | eoeeccwcewecewe |omeweccccereoee| > = VOL ENTRY O > ENTRY 1 
3{ OF SYSTEM VOLUNE SET |3 LWEV = 1. | 4 VENT ? } (DOUBLE) | (FVTRBX = 1) 
4| 0 \4 | l | | 
| --nnenennnennnennenenecnn---===| | ae . | 
5| 0 is | ; " 
| poewe nnn nn ewww enneowenoennnne- | \ ENTRY 0 | | | 
| | / (MVTREX ® 0) | -cosense ceecces | swereewenennen= i \ | 
! a | 24] eV | —- VTRBX 20 | | 
- = | | ponnn nn wwne wen fooemecnccccnene| => = VOL ENTRY 7 | 
| | { | 25] VCNT j2t | (DOUBLE) v 
| --neenaeannnonnnnnnnnnnnennnne- | | |n--eennccnnennnencnemnnnnnmnnnnn | / --- 
1 2 0 \17 
[| 2) 0 118 I ! 
| 23) 0 [19 | o . 
|----enenennenennnn- wennneneee --| | | 
1 24] 0 {20 v | | 
|-----nnnnnennnnnannnnnnnnnnnnen| --- | | 
|------- onnnnnnnennnnnne-————| --- 
i | 
|: I | 
j | | 
> ENTRY vn - 1 
- = | (IVTRBX 2 An - 1) 
| | | 
| l | 
l | v 
| ----------------------n-------+| -- 
6.23.00 6.23.00 
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Private Volunes/Serial Disc Private Volunes/Serial Disc 





Mounted Volunge Ts (VIRB Private Volune User Table (PVUSER 
| OST. 2 54 (%66)/SIR = 29 (Z35) 
[ _slolesrss|tercceece=sessceetser=” as 1111 
ne CYCL| DIRCSIZE/32 {0 ; 2 . 2 ec ae Aa : 
1] HVOL | MVOL | \4 ! o| TABLE SIZE clasps) 4 : 
pase a Se Ueuosic owesceeeuweeeseuoeseae 
2| LDEV | DIRBASE |2 1 i # OF ENTRIES \1 : 
| —madeuseeueweace °° 9) eS LES RR SS SRE RS ORES ee 
3] OF VOLWUNE SET 13 | i 2] BITMASK OF MVTABX’S |2 | 
| eon cwnnn on cenn nnn nnencoocnscce | | ! REPRESENTED | | 
4] UCNT (4 | nenenennne nnn nnnnnn nen ecenenans | >» = TABLE HEAD 
| peewcenmenonn ce meeronnnneosooce ! ; )} 3 MAXINUM TABLE SIZE (WORDS) I3 | (5 WORDS) 
5| GENERATION NUMBER 15 | | eenewewenenenennnnnewncnenenene | 
| ewww nee eccoenen | onenoecnce wooee|  \ | } 4] RVAILABLE POINTER 4 v 
6! LOEV 1 VTRBX 16 | | | cocccceweneennn | eorenenoeneeen= ooe 
acceceeneesnens |oooennsresensee | > = VOL ENTRY © > - ENTRY n | S| OPMASK | mrTABX {5 \ : 
7| VENT 17 | (DOUBLE) | (INTREX * n) | eoweneeennennne | enonnne en nnn nee ; | | 
! meocccoencoenncneonoonensoncooe / | | Z MAX USERS ic | | 
— & z | | 7] # PINs |? > = ENTRY KEAD | 
x . | | crew eee w owen nn nc connor eocceroore i | (§ woRos) | 
| \ | 10] CURRENT SIZE OF ENTRY , 18 | | 
| 24] LOEV | VTABX 120 | | | 14] PV FLAGS jor |9 / | 
| coon ww weneecone | onneennee enecce | » - VOL ENTRY 7 | ee ete |---| | 
| at VCNT {21 } (DOUBLE) v |} 12| VARSK 1 , 
{ 13] FIN 1a | | 
U = In Use (1) [eeereernnssecseecowa sseses ese | | 
Not Used (0) } 14] “USER BIND COUNT us | 
CYCL - Cyclical volune index | 15 USER MOUNT COUNT 113 | | 
(local VIRBX) for dase | eonnceneencennnnneweenenneee woe] | | 
space allocation | 16] SYSTEN BIND COUNT ha - USER ENTRY 
wewcweccecccoccswwoennenwocccce 1 
HVOL - Highest (ordinal) volune ) 17| SYSTEM MOUNT COUNT 115 | | 
index (volune index being the | eoewenc wren ennenenwncoecooce os | | 
volune set's local VTRBX) of a | 20} BIND NANES COUNT 116 | | 
mounted nenber of the volune = J [eeeeorccoroerooserecrocreosonse | | | 
set (class) | 21] OST # OF BIND NANES Ji? | | 
| ENT | / | 
KVOL - W of volumes mounted for the i —is—‘(‘é‘éléislélél [eee re rence nreno non erawcccsenene | | 
volune set (clases) | a VARSK ve \ 
UCNT - # of users having mounted | 23} PIN 119 | | 
the volune set | co cee ne new nwewewnwewnnwceerocee 1 | >» - VOLUME SET 
} 24| USER BIND seseiie {20 | | ENTRY 1 
VCNT - Woof users having mounted [ner ernn error sonnrorcccseweccornn i | | (MVTABK = J) 
the volune. | et USER MOUNT COUNT 21 
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(Created and managed via PVUSER Table) 


| BPO OS SC PFOS SSS OSL SSE O88 SHSTSEESSSOD | 











| 26] SYSTEM BIND COUNT {22> - sae al ! ; 
Sonera eas ORNS SAO eno Se 11111 
| 27] SYSTEN _ROUNT COUNT 123 | | 3456789012345 
sewewecennneseccecneccoococcene | | PRFEPEE EEE I-I-1-1-I-[-{ --- 
| 30} BIND NANES COUNT fe | | 0! fIAX SEGMENT LENGTH t) i 
| 31] DST # OF BIND NANES {25 | 1| CURRENT SEGHENT LENGTH = |1 | 
| 32] SEGHENT j26 / | -enc nen wcenwnenweencecennnennee 
[seeteteseretsaaeneneenetsessee| | 2| 0 j2 
7 : . | | -onennenewnccccnc renew ecconcnee| | 
; | | { | 
|--+2- cocesenenenna as | \ | ] ! b iad ENTRY 0 
| VIASK i | | | 
| poecennneeeenecee ---| | | 7 “ | 
| PIN i | | | 
| PROPS 240 2 G22S2 £2OES86O94S22SES8 SECTOSSECSSES | | ] | | | 
USER BIND COUNT | | 
USER MOUNT COUNT | | 10) 0 \s v 
| SYSTEM BIND COUNT | - USER ENTRY | | BIND COUNT ie fl 
ee eo oe Se eee ee oe ee ee oe fi BPPSSSSVES SO 6 6 OF 68 GESS 2292S G0E0R7 S868 
| SYSTEM MOUNT COUNT | " " 
| BIND NAMES COUNT | | 2| |2 | 
| eevececnecenennceseencnne conc j { |- GROUP WANE -{ | 
| DST # OF BIND WANES | | 3] 13 | 
| ENT / v |- -| | 
‘ sd _ (5 
| OP RASK | MVTRBK | 6] ACCOUNT KANE 16 | 
nn nn | | VOLUME SET \- -| | 
| | > - ENTRY n 7| |? | 
: i | (m1Rex = K) \- -| 
. - v 10] \8 v 
a eee | a+ | onan en nee neem ree me eennnnenonnn | oc 
| a | | | 
| Vv | | | 
| a | I ! 
= I ae 
L 
a A @ 
| 8 | 
| L | 
| E | 
| eomon ewww nw nnn nnn non nnnnnnnnne| 
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Bind Nanes Data Seqnent (Cont.) 


| corn nn nnn ee reno none nono nercenn= ! -- 
Oo} BIND COUNT ie , 
| eee mec ce ceeeewecccecoseoosossore 
1{ \1 | 
|- -| | 
2] |2 | 
j- GROUP NAME -| | 
3] |3 | 
l- -| | 
4| 14 > = ENTRY a 
| enon nen e enone nen en enon nnn eernno| | 
5| iS | 
|- -| | 
6| 16 | 
|- ACCOUNT NANE -| | 
7| \7 | 
I- -| | 
10| rE v 
| enn cceen nnn nn nocerereemoseccnn= | “-- 
| A | 
| v | 
| A 1 
= T 
L 
a 
oo 8 yy 
| L | 
| E | 
| ceoeenc enw nnn nncoccccoensonsone | 
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End-of -File Fornat 


Files start on a sector boundary, and end on one. The End-of-File consists 
of a 0 record length and 0-fill to the end of the current sector as follous: 


| 
| 
RL RL | SECTOR n 
{ 
| 


An End-of-File entry is made in the Gap Table, so that files nay be skipped 
by scanning Gap Table entries instead of serially scanning the data area. 
Sefer to "Gap Table Fornat" in this chapter for detailed informatica. 
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Serial Disc Tables and Data Structures 


Data Record Fornat 


The prinary purpose of the Serial Disc Interface (SOISC) is to adapt the 
undefined length transfers characteristic of magnetic tape to the 
fixed-length environment of a disc or cartridge tape (CTAPE). To acconplish 
this, data 18 buffered within SDISC. The buffer as an integral nunber of 
sectors (blocks for the CTRPE) long. Files always start on a sector 
boundary, but data records within files may start anywhere and straddle 
sector boundaries. A record in the buffer is structured as follous: 


| | 
| RECORD | | RECORD | 
| LENGTH | DATA | LENGTH | 
| (BYTES) ! (BYTES) | 


The record length is always a one-word positive byte count which includes 
only the data portion of the record, not the length uords thenselves. Records 
within a file might be stored on the disc as follous: 


| 
| Re | | = 
Joocee | mon en- | ----  Ratatated Ketetanetetatatatete | | 
| j RL | RL | | | 
| enooneneene| ----|--]-]--|----1--] SECTOR n - 1 
| {RL REI I | 
|-o-eee- wrececcosene Jeoe-|----|--] | 
| | v 
| enw | enne | enon fo nen eowennnneeneee| ag 
{ | RLI RL] | 
|---| -nn= |---| -- |---| -----2----] { 
| } RL RL | { | 
| -r--eeennee |---| ----| |----]|----] SECTOR a 
| J RL I RL | | 
 atatetatateiatahtatateteteeatatatatenenaial Jocee| oor | | 

| v 


| RL RL|..... | 
| Jore=|----] 


The reason for the trailing byte count is to inplenent an easy way to 
backspace records. 
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A serial diec can perform all the tasks that a magnetic tape can do. It can 
also be a coldload device. The machine microcode nust be able to read a 
bootstrap channel pregran and the resident segnents of INITIAL fron the disc 
into nenory. The microcode and channel prograns cannot interpret the record 
length uords which surround standard data records. A structure, called a 
CONTIGUOUS BLOCK, which has the data without the length words is utilized. 
Infornation as to the length of each contiguous block is stored elsewhere. 
Entries in the Gap Table hold the beginning and ending sector addresses of 
each contiguous block. Each block must begin and end on a sector boundary. 
To distinguish centiguous blocks fren normal data, a record length and a fill 
character of 2177777 is used, as follous: 


aeueswcecaccccscoenenocewerce== | Susie 
PREVICUS RECORDS | 1 


| 

| 

| | 

| RL | -1 SECTOR n - 1 

| -----e en omen =| | 

| | 

{ -{ FILL | 

| v 

|-------- seeccowwenecocosocscoce = 

CONTIGUOUS BLOCK SECTOR n 

v 


~ 


| 2eeeeeeenoer eee 


| 
eat nei 


| -1 FILL 


v 


Hole Fornst 


Holes on the serial disc have the sane fcrnat as contigucus blocks (they 
gtart and end on sector boundaries with -1 fall characters as required). 
Starting with NPE version G.0C.00, holes are oteclete and SOISC will not 
generate then. Houever, code has been left in SDISC *: process any holes 
found on serial discs written with earlier versions of SOISC. Further 
details nay be found in the Serial Disc IAS. 
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Table Forna 


The Gap Table is a four-uord header followed by 2 series of tuo-uword device 
address entries. A pernanent copy is on the device, starting in sector 4, 
while a working copy 1s 1 main menory. The copy in menory is posted to the 
disc only uhen a backspace or rewind cperation occurs after uriting (uhen the 
copy in nain nenory has changed). The length of the Gap Table is 
device-dependent according to the table below: 


Device Nunber or Secto or CTAPE blocks 

KP 7920 4a 

KP 7925 106 

HP 7933/35 219 (250 for 6.00.00 and later releases.) 
HP 7902/9895 26 


HP 35401/HP 9110/HP 9144 4 blocks ("S" cartridge) 
HP 35401/HP 9110/HP 9144 15 blocks (“L” cartridge) 


The following is an illustration of the Gap Table: 


| 119191 
$ 0123456789012345 
1 lelefet-lel-f-l-l-lefet-b-l-l-l-d \ 
O| SECTOR ADDR OF LOAD POINT i] 
1| UNUSED i] 
2| UNUSED | > - GAP TABLE HEADER 
3| UNUSED 1 | 
| |-eeee Joon--- eoceweconwccccconne i/ 
| 4| TYPE] | 
| ‘t cooce | SECTOR AODRESS | ENTRY (2 WORDS) 
| |reenelo- wocccoceorone wccccce one| 
| 6} TYPE| | 
| | orene } SECTOR ADDRESS ENTRY (2 WORDS) 
| orenenw wenn newcowcnnnnnnencccce| 
6.23.00 
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SOISC Extra Data Seanents 


With feu exceptions, SDISC operates entirely in split-stack node using en 
extra data segnent for working storage. Starting with NPE version 6.00.00, 
there are tuo additional data segnents used as no-wait data buffers. For the 
ost part, the discussion here is restricted to the original data segqnent, 
now used only for variables, the Gap Table, and data buffer nanagenent. 


The working storage extra data segnent (XDS) is usually acquired by the 
external procedure ALLOCATE when the serial disc device is first assigned to 
a user as pert of an FOPEN. The external procedure DERLLOCATE relesses the 
XDS in processing the final FCLOSE against the device. The systen progran 
PVPROC nay also acquire and release an XDS to allow the tape label routines 
in LABSEG to use SDISC when DEVREC processes a device cn-line interrupt. 
SDISC allocates the tuo data buffer segnents as they are needed, then 
releases then as part of the Device Close procedure. 


The XDS contains the global storage area for SDISC, including the data buffer 
nanagenent area (BUFFER INFO), and a small buffer (called WORKTABLE). The 
contents of the Serial Disc label sector is stored in UORKTRBLE when it is 
read in by SOISC as part of the self-configuration. The Defective Tracks 
Table (NAC fanily discs) or Defective Sector Table (CS8 discs) is also 
stored in WORKTABLE while suspect or deleted tracks are being reassigned. 


The three arrays in the XOS (WORKTABLE, BUFFER’ INFO and GPT (Gap Table)) are 
dynanically configured by SDISC as indirect arrays. The array nanes are 
declared as pointers, then appropriately conputed elenent-O addresses are 
inserted in then. 
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The type field is bite 0, 1 and 2 of the firet uord. The eight possible 
types are: 


©. END-OF-FILE. The asscciated sector address contains cone or nore 
end-of-file fill characters (0) to fill cut that sector. If the record 
ends exactly at a sector boundary, the following end-of-file sector 
contains ali zeros. 


1. END-OF-DATA. The associated sector address is the last address of valid 
data plus 1, (the next available address). Such an entry 18 usually 
preceded by an end-of-file entry. The £00 entry is written when uriting 
terninates. The file systen will not backspace or rewind after writing 
without sending a WRITE END-OF-FILE. An EOD entry is also written at the 
beginning of the Gap Table when new (unuritten) media is inserted. This 
prevents erronecus reading of blank nedia. 


2. BEGINNING OF HOLE. The starting address of a defective area of the disc. 
It as usually found on a track boundary, but may be an mid-track if a 
contiguous block was being uritten when the defect was encountered. 
Obsolete, starting with NPE version 6.00.00. 


3. END OF HOLE. The corresponding ending address of the defective area. It 
is aluays found at a track boundary. Obsolete, starting with APE version 
6.00.00. 


4. BEGINNING OF (CONTIGUGUS) BLOCK. The starting address of a contiguous 
block, exclusive of the -1 fill characters which nay have been required 
to get to a sector boundary. Unlike the End-of-File fill characters, 
there need not be any -1 characters if the previous record or contiguous 
block (wath or without the trailing length word) ended exactly on a 
sector boundary. 


5. END OF (CONTIGUOUS) BLOCK. The addrese of the last sector containing 
contiguous bleck data. The sector may also contain -1 fill characters to 
get to a sector boundary, but ae with the beginning of block they are not 
required if the contiguous block ends exactly on a sector boundary. 


&. END OF TAPE AARK. The sector address of the sinulated End-of-Tape 
reflector. This type is now uritten only to floppy discs for use by the 
INITIAL serial dise interface. When read by the MPE SOISC, it is skipped 
no matter what device it is found cn. This ensures compatability with 
older serial discs. 


7. END OF GRP TABLE. No associated sector address. This type is created 
whenever the Gap Table 18 cleared, by initializing the table to -1. 


6.23.00 
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The extra data segnent is organized as follous: 


0| WOROSPERSECTR jo 


SO8202 08008 26 OS8C88O88SE0 


SECTORSPERTRAK i 


—_—_ es = oD 
= 
—_ 


2I STARTADORESS {2 SIMULATED BEGINNING-OF -TAPE 
a] erste SIMULATED END-OF -TAPE 

1 4 4 

| sl eupsectn: Pie 15 LAST SECTOR OF DISC 

1 6 {6 

1 oa yustauiocates 

10) unites 

ert ee - 

12] wone'FaTaL 10 


| 13] KON’VOL’SPECIFIC’FLAGS |11 


SSO S2G2SFS8S28ONSTS2E2SO2RSE80 


{ 14] FAX’ DSEG’ SIZE 112 





| 15] SOISC j13 
| | 
| | 
| | 
| WORK TABLE ! 
| | 
| QUFFER’ INFO 
os | 
| | 
| GRP TABLE 
|-eneeeen-nnnnvnnnneonnn>| 
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The first thirteen words are reserved for use when the data secnent 1s 
created. The first seven words are filled uath information taken fron the 
label sector, and the last six are filled by ALLOCATE. 


WORDSPERSECTR - Words per sector 
SECTORSPERTRAK - Sectors per track 
STARTRODRESS - Sinulates Beginning-of-Tape 
EOTSECTR - Sinulates End-of -Tape 
EGDSECTR - Sinulates tape runoff 
JUSTALLOCATED - Initializes SOISC paraneters to 807 if true 
WRITERING - Sinulates tape write ring 
FATALERROR - Disables SDISC pernanently uhen true 
VOLUME’ FATAL ° roobgead SOISC until a new volune is mounted uher 


NON’VOL’SPECIFIC’FLAGS - SDISC global flags that are non-volune specific. 
MAX’ OSEG’ SIZE ~ Naxinun size of the X0S 


SDISC - Global variables, including array pointers 
WORKTABLE - Length is 512 words 
BUFFER’ INFO - Length is calculated as: 


MAX’ NUN’ BUFFERS (currently 2) 
INFO'ENTRY’SIZE (currently 8) 


GAP TABLE - Length varies with device - is calculated by the 
SOISC routine as part of self-configuration 
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HAPTER 1 
0 Ta inka 


[onereonee 


be dietiabuss laste sconcadeneesesy COGICAL. \\ t Nk 
\ DEVICE / 


\ene=|=-=-/ 


f-- | OTP | 


/ 

| 

| 

| 

| 

| 

| 

| 

| 

| } | | 
| \-->] FLAGS = | <------~--- =| 
| | T 
! | oITe | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

\ 


| 
fee aa | 
T0Q* co 4 DLTP | 
\eree>] FLAGS | | } ITP |--\ | 
soccereee=| | Jonnneenen-| ILT | 
} reer | | cresnoeae= | 
|reeeeneene| | \--o>|----el-----] | 
ccconoee| = LDEV | fecene=>fCH} =| ORT I | 
Joonnncen-| | | o-fo-|--ef-----] | 
mT | | Pa 
| pa ny Meee | 
| { | | STOP |; ae] | 
|noeweee oo-| | | | SIZE | | 
| | | | se 
J OL = fcneeen/ | | 
| | | Jewenennne-o- | J oUNIT 
| | i | DITP = [<--/ 
mee Ee 
i i * 7 
RN NO coceecpeampamni 
v \-o} SIO PROG | 
! ! RARER 
ORT ! 
| | sIcPp | 
| Jeooro--o--=-| 
| PI i 
\eneone >| ILTP 
* ORO for disc requests | | 
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Private Volunes/Serial Disc 
Seria) Orsc Organazation 
The disc is organized as follous: 


| 
| LABEL SECTOR ]0 See expanded view in Chapter 3. 


t OTT/DSC* ‘ DTT (MAC fanaly) or OSCT (CS8). 
( 2 £@2e Se Rees eZ een SBeOCe 

| COLD LORD |2  HP-IB cold load channel prog. 
| eonewnenen--nonenen eee 

| SOF TOUNP : SOFTOUNP channel progran. 

| ennannee--n- nnn nen enne 

| GAP TRBLE ‘i TO STARTADORESS - 1. 

i | | 

| DATR | STARTRODRESS 

| ‘ ; 

| | ‘ 

| | TO 

|encacceeens  sreeeceee | : 

| EQTSECTR 

| | TO 


| LAST DATA SECTOR | EODSECTR 
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Device Reference Tab ORT 


HP-18 SYSTEMS 


RES | SS OOS 8 OSS BOR SS SOTTO DESO TOSS | 


| ~ BANK OF ORT \ 
> 
| zit OFFSET OF ORT IN BANK | / 


| 

wawcewas cose cesenssousananee | 

| 

ORT ENTRY ON /33, /44 | 

| STOP | (nceecnee/ 
| DBI | 
Jannn--n=- nenneneneennnnnnnne 
| PI | 
| CHANNEL FLAGS | 


2882 2S SSS 29 8SSSSES8 OS SESESESEH00 | 


SIOP - Absolute address of SIO progran. 
PI ~ Interrupt handler PLABEL. 
DBI - This is the absolute address of the ILT. 


river Linkage Table (DLT 


45 6 7 8 9 10 11 12 13 14 15 


0] QUEUE NUNBER alae afi) ps ibaa 
af nonatar uaa e 
al initzatoe PUEL pr ater 
lee loconp 
1. Tom 
6} on sie \Sevice WE OTVPE 
6 ts baiver EDITOR PLEL SS ~| 
7] nti P98 pram as | 
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There ie one DLT for each type of driver. A pointer in the DIT allous 
different devices on a controller to have different drivers and 
interrupt handlers. 


DPROC.QNUNB - This field contains the 1/0 process request queue 
nunber for type 2 drivers - zero for all other types. 


. (8:1). ORVRFRZN - Driver code frozen - set by NAM uhen the driver 
(OF) code seqnent has been made present and frozen fron a 
request fron SIODA. 


. (9:1). MAMERRORC - MAM Error on Code Makepresent. 
(RC) 


.(10:1).CORERES - If set both initiator and conpletor code are core 
(CR) resident. 


. (14:2) ORVRTYPE - ORIVER/AONITOR TYPE 
(NTVP) 0 - Not used. 
1 - Driver can be executed on any stack. 
2 - Driver can be executed in the user process or 
in the I/0 process identified by IDNUNG. 
3° Canina? in process whose PC8 nunber is in 


DANTR - I/O Renitor PLABEL. 
DINIT - Driver Initiator Procedure PLABEL. 
DCOMP - Driver Conpletor Procedure PLABEL. 


DINTP - Special Interrupt Handler PLABEL - called 
by GIP if ISPEC is eet OFLAG (no other action is 
taken by GIP except to set the Interrupt Status 
in DSTAT). 


OTYPE.DITSIZE - The length of the DIT in words for thie driver. 
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Entry 0 


6 7 8 9 10 11 12 13 14 15 
Fe ed ed ed dt a 
Oo} NUMBER OF ENTRIES IN TRBLE 


2898 C098 SO4 09 OS0SE8 OS OF 69S 8ESE89808S8OSESS8 ©OSSSEURE8S80 


1| ENTRY SIZE = 4 


2] DEVREC SERVICE REQUEST COUNT | 


F228 S2SS8 SS 22489 OF £249 £2 SS SS SESE 289 O29 25ES8S 284205 O88 


3| i 





Word 2 is increnented by a device driver whenever it sets the Device 
Cunership State field (below) to 2 (Service Requested). DEVREC decrenents the 
count for each interrupt it services until the count reaches 0, at which tine 
DEVREC hibernates. 


-- CAUTION -- 


Device drivers must leck this table by using 
DISABLE/ENRBLE, not by trying to scquire 
the LPOT SIR. 


ical Ent Vi vic 


123 4 5 6 7 8 9 10 11 12 13 14 1§ 


|--|--|-=|-=]--1-=1--1--1-=L-=L-=]-=1--1-1--1--| 
Ol 14 POINTER TO XDD SUBENTRY 


0 | 00 06 © 080 68 0826 0022 COHSCOS4 088820808 202008890208 | 


1 | 


| SOO OSS OS OC 0 OSE 68S OE OES OSES 2899454 2846 0846045 2HOE888 


2| 


| oe | OO 909808208 8S8SS OSE F EDGES 2E8 OBS OHOSOSOSSCSESO 


3}I10] 


| ee | 8908908920606 0029628 4 0928 OSS8ESER SF OSSS SS8SSE2 | 


10 -- 0 for input, 1 for cutput. 


Word 0, bit O is 1 for a virtual device, 0 for a real device. The fields in 
uord 1 are the sane, as applicable, as for the real device represented by a 
gaven virtual device. See below. 
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Loqical-To-Physical Device Table (LPOT) 


| OST = 13 (215) 
1 SIR * 9 (Z11) 


The LPDT has several fields which describe the estate of a device. Sone of 
these fields have the sane neaning for all devices. Others are device 
dependent. All are described belou. 


There are tuo types of devices represented in the LPOT: real devices and 
virtual devices. A real device is one which has been configured into the 
systen and is capable of performing input and/or output. A virtual device 
sinulates sone of the properties of a real device (for exanple a spcoled line 
printer or an INP), but there is no physical I/0 involved. The tuo nain uses 
for virtual devices are for OPEN spooled devicefiles and certain 
connunication devices (such as INPs). 


A given virtual device entry is in use only uhile the devicefile it 
represents is open. When the file 1s closed by FCLOSE, the entry becones 
available for another virtual device. This is the reason for the 
SYSDUMP/INITIAL configurator question MAX # OF CPEN SPOOLFILES--1t needs to 
i how many virtual device entries to allocate to the LPDT (and to the 
LOT). 


Entries in the LPOT are ordered by logical device nunber. The first word 
address of a real device entry is obtained by multiplying the LDN by the 
entry size. Except for the Oth entry, entries for which no logical device is 
configured on a given systen are used for virtual device entries. Any 
renaining virtual device entries follow the last real device entry. 
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Typi All Rea vices 


60123 45 6 7 8 § 10 11 12 13 14 15 


| 
4] © [| 2] 3t | 5) 6] 7 (EOF)] | [12 SUBTYPE | 


2| SYSDB - RELATIVE POINTER TO THE DIT | 


3| | 


© = Word 1.( 0:2) - Device Qunership State: 

0 ~- Not ouned by any process. 

1 - Ouned by a process. 

2 = Service requested - set by driver for 
unexpected interrupt, then wakes DEVREC. 

3 - Device reserved (alternate use) - set 
during :STRRTSPOOL to renove the device 
fron the pool of available devices uhile 
other checks are nade or rescurces are 
acquired; the field is set to 1 uhen 
these steps are cenpleted. 


2 = Word 1.( 2:1) = Device is Job/Session Accepting if true. 
3 - Word 1.( 3:1) - Device is Data Accepting if true. 


5 - word 1.( 5:1) - Oevice is Ouplicative if true (all devices 
except discs). 


6 - Word 1.( 6:1) - Device is Interactive if true (all devices 
except discs). 


7 - Word 1.( 7:3) - End of File condition: 
0 - Mo EOF detected. 
1 - Hardware EOF (e.9., tape nark). 
DATA record read. 
:E00 record read. 
sHELLO record read. 
BYE record read. 
3J0B8 record read. 
3EQJ record read. 


WAM Sans 


12 - Word 1.(12:4) - Device subtype - see discussicn for tape entry 
(below) for a description of the Auto bit (12:1). 


The renaining bite in Word 1 are device-dependent and are described with 
their corresponding entry diagran. 
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Entry for Terninal-Like Devices 


3465 6 7 8 910 11 12 13 14 15 


ae 
7 SYSDB - RELATIVE POINTER TO THE OIT 
131 | 3| \ 
| |-------- a nonnnnnnnnneneenne| 


3 - Word 3.( 3:1) - If set, NLIO translation is invoked for ALL data 
transferred to and fron the device. 


4 - Word 1.( 4:1) - Control-¥ is allowed and has been detected. 


10 = Word 1.(10:1) - BREAK has been detected. Ignore BREAK if the CI is 
running. 


11 - Word 1.(11:1) - The terminal is logging on - this bit is set by PROGEN 
and DEVREC when the logon sequence starts. If the bit 
is off when polled by INITJSNP the terninal has 
disconnected. Only IOTERMO and HIOTERN HIOTERM support 
the use of this bit. Multipoint and OS pseudo-terninals 
do not. 


Entry for Tage Drives 


345 6 7 8 9 10 11 12 13 14 15 


GORE se Ree 

Z| rhe - RELATIVE POINTER TO THE DIT l 

3} JAR| | 
I--| 


4 - Word 1.( 4:1) - BOT. Tape is at Load Point -OR- no tape nounted. 
Recording density may only be suitched uhen this bit is 
true (for nultiple density tape drives). 


11 - Word 1.(11:1) - If true, DEVREC is perforning Rutcnatic Volune 
Recognition (AVR) on a tape (or PVPROC is doing the sane 
on a serial disc), -OR- RVR is to be suppressed on job 
or data accepting devices. 


12 - Word 1.(12:1) - Part of Device Subtype field. If true, device nay be 
allocated autonatically when opened. If false, operator 


&.23.00 
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Qverview of Data Seanent 


| OST 14 (216) 
| SIR 10 (X12) 





manne a= | (== DST 216 
LOGICAL DEVICE 

TABLE 

(LDT) 


LOGICAL DEVICE 


! | 
| 
| | 
| | 
| 
| | 
| FBS O FOSS 0829S O2O2SS8SE 2046809808 | 
| | 
| TABLE EXTENSION | 
(LDTX) 


Zero Entry Fornat 


12 3 4 5 6 7 8 9 10 11 12 13 14 15 

so os et be bd od Pd ed ed ed 
0} HIGHEST ENTRY NUMBER ! 
4 ENTRY SIZE = 7 
2 STRERNS DEVICE NURSER 


3] ! 


| 8990 O888O COS OS8OCS C8468 08O8 48 89S 29882 2E88E2808824860E8 898 | 


4 | 


SS BOSS 6889S 0SS808SS 28OEE4 8 8 B24 OF 824 ©BSSSSSS8ESS4O88 ] 


| (098 C0 OSS4 68S99E 48S 898E2ES49SESE4EE CGS SCOOSDSOSESHOSFS 


6| | 


| SBS C0 OOS OS O86 OSES E982S8SE 6 SSS SSOS SS OSSSSESSOSETSSEO | 
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AR - Word 3.( 2:1) - must allocate. AUTO REPLY. Device may be allocated 
without pronpting the operator for REPLY if certain 
run-tine conditions are met; this bit 18 set 
automatically af word 1.(12:1) is TRUE. 


Entry for Disc Orives 


01234 § 6 7 8 91011 12 13 14 15 
fos esteetee lalzed olan erlrclsetoel<loslec tra 


01 0 
J--]--]--|--|--1--[--]-------- |o- [= |eree neon | 
yo | Fl UT 4t SI 6 j104 11] | 
2| SYSOB - RELATIVE POINTER TO THE OIT | 
| eol an | on | eccwcc cccc se wencewnwoenacccoscesoures 
3] |SDIAR} [ 
|--|--l--} 


© - Word 1.( 0:2) - Device Ownership State. May not be 1 (ouned) for shared 
device (systen volune or private volune). Serial and 
foreign discs are non-sharable and may be ouned. See the 
full discussion of this field under Typical Entry, 
above. 


4 - Word 1.( 4:1) - If true, the disc is a nonsysten donain (private volune, 
serial disc or foreign disc) disc drive. 


5 - Word 1.( 5:1) - If true, dise 1s a mounted private volune. 


6 - Word 1.( 6:1) - If trve, the dise is a reserved volune used to satisfy 
the requirenents of a multiple volune private volune 
set. 


10 - Word 1.(10:1) - If true, the disc is a physically and logically mounted 
serial or foreign disc. Bits 5 and 6 nust be false. 


11 - Word 1.(11:1) - If bit 10 is true, then 1 22> foreign disc, 0 22> serial 
disc. 


SO - Word 3.( 1:1) - If true, the device is currently being used as a serial 
disc (that is, it is allocated to a user as a serial 
disc). This bit duplicates a bit in the LDTX entry so 
that this infornation can be found in a eysten 
(nenory-resident) table. 


AR - Word 3.( 2:1) - AUTO REPLY (serial or foreign disc only) Device may be 
allocated without prompting the cperator if certain 
run-tine conditions are net. 
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1/0 
Typical Entry Forna 


0123 4 5 6 7 8 §¥ 10 11 12 13 14 15 
|--|--|-=|-=[-=[-=1-=-ef-=1-e1--l--1--1--1 1-1 
. FILE USE COUNT 
} 4] VOLUNE TABLE INDEX IF DEVICE TYPE = 0-7, 
1 ELSE MARIN PROCESS PIN &, 
i | OR SPOOLER PROCESS PIN @ 


| 2l RECORD WIOTH ICSIFO} DEVICE TYPE | 


| BISPOOL|SYJDI/ON{TRIHDJCLISQ| DEVICE - DEPENDENT | 





} 4)UK} XOD HEAD INDEX | 
| sl CONTROL-Y PIN | 
i 6| DEFAULT OUTPUT DEVICE -OR- | 

| DEFAULT CLASS INDEX | 


CS - Word 2.(8:1) - Connunication systen device if set. 
FO - Word 2.(9:1) - If set, there are special forns nounted cn the 


device. 
Word 3.(0:2) - Spooled state of the device: 
0 - Not spooled. 
1 - Ouned by an input spooler. 
2 - Ouned by an output spooler. 


SY - Word 3.(2:1) - Device is available to systen (not doun). 

DI - Word 3.(3:1) - Device is available to diagnostics (cbs). 

DN - Word 3.(4:1) - :DOWN requested, honored when use count © 0. 

TR - Word 3.(5:1) - If set, trailers are disabled. 

KD - Word 3.(6:1) - If set, headers are disabled; these tuo bits are 


managed such that header/trailers are generated in 
pairs or not at all. 

CL ~ Word 3.(7:1) - If 1/0, word 6 is the Device Class Table 
index/LDEV4 of the default cutput clase/device 
associated with this device. 

SQ - Yord 3.(8:1) - Spooling has been enabled (spcol queues are 
open) for this device. 

Uord 3.(9:1) - Device dependent infornation: 
1. For terninal-like devices, the default 
terninal type to be used if not specified 
in the : HELLO connand. 
2. For variable density tape drives. 
Word 3.(10:3) - Actual tape density. 
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Word 3.(13:3) - Density requested in FOPEN for urites to 
unlabeled tapes only. 
For either: 
© = unknown density/no FOPEN u/urite 
1 = 1600 BPI 
2 = 6250 GPT 
3= 800 6PI 
Word 4.( 0:1) - Auxiliary lock nechanisn - if set, device is 
being dealiocated but LOT and XDD are 
inconsistent and their SIRs are released; 
:ALLOCATE cooperates by rejecting access to 
the device. 


ica vice Table Extension TX 


Overview of a nent 


| DST 14 (216) |rcceeneewnnnnnnennnnnennce=|(on-=DST X16 
| SIR 10 (x12) 
LOGICAL DEVICE TABLE 
(LOT) F 


LOGICAL DEVICE TABLE 
EXTENSION 


| 
| 
| 
| 
( 
| 
| 
! 
| (LDTX) 
| 
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rnin n 


0123465 67 8 910 11 1213 14 15 
Jo-|oofoe|o-fo-]--|--f--1--|--f--l--le-l--l--l-- 
0] 0 O| Of 0] O| RESERVED =| 


1] TERMINAL DESCRIPTOR TABLE OFFSET 








Z| CHANNEL IO 
3] WLIO XOS 
4| 





TBRC = Terninal’s baud rate code (CPS = characters per second). 


Speed (CPS) ROCC/ATP (HPIB) TERC 
Not knoun 0 
1920 16 (ATP only) 
960 8 
48 § 
24 7 
120 11 
60 6 
xn 13 
1§ 14 
14 woe 
10 45 


US = This terninal ie connected to a Workstation Configurator port. 


TOT = Offset fron the base of the Terninal Descriptor 
Table (TOT) to the TOT entry for this terminal. A 
-1 indicates no TOT entry exists for this terninal. 


NLIO XOS = Extra Data Segnent Munber of Working storage for 
NLIO translation. 
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01234 5 67 8 91011 12 13 14 15 
ed ed ed dd edd ed ed ed dae 


0} HIGHEST ENTRY NUMBER 
| 
1] ENTRY SIZE = 5 | 


|---newnnnnnncnnnnnenncnnncennnencnnnncennncnans | 

| 

3| | 

|nenennnnnenecnnnnnnennne wanannnnsennernnnncnn | 

4| | 

|--------nn----- wnnnnenneenccncnonnenennsnnnene= | 
Typical En 


01234 5 6 7 8 9 1011 12 13 14 15 


--|-- o-|-- w= |--|--|--]--]--1--|--]}--l--!-- --| 


| 
O| SISDICPIFSIDS| RESERVED | 


1| DEVICE-SPECIFIC INFORMATION FIELDS 


| 

| 

-| 

| 

| REFER TO THE FOLLOWING EXAMPLES | 

"| (LDTX ENTRIES) | 
Where: 


$ = Seek ahead enable/disable flag (systen or PV disc only). 


$D = This logical device is a Serial or Foreign Disc. 
CP = This logical device uses the CIPER protocol. 


FS = This 18 a systen or PV disc with Disc Free Space nanagenent. 


OS = This LDEV is a OS or data connunications device. 
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eri r_ Fforegian Di nt 


RESERVE 


| 
1] SOISC: DS FOR VARIABLES, GAP TABLE 
| FOISC: 1 


| PESOS ® £224 £24 2SE4S4 6 2228242898 SE82E86S80082082 SOS RWSSOSOS 


l 
| 
2] SOISC: 1 = DATA BUFFER XDS’S ACQUIRED 
| 
| 
l 


! FOISC: NOT USED 


3| SOISC: PCB INDEX WHEN WRITING, ELSE 0 
| FDISC: NOT USED 


28S 22S B22GSS OS 64 2 BSS SOESSHSHESSEOG: Et Le PPE LOE: Se I OR TE 
4| 


PER En 


' ‘i sf 34 § 6 7 8 9 10 11 12 13 14 15 
O] 0] Of 11 0] Of RESERVED 08) 


tf pele DEVICE CONTROL DATA SEGHENT # (CBCDS) | 
a CTN INDEX FOR THIS DEVICE (CTAI) | 
3| 


| 
] 
4| | 
l 


08 = If set tc 1, then debugging is in effect. 


ON = If 1, the CIPER facility has been deactivated for this 


device because cf error. 
CINI = Control Tacle Nap Index (an index inte the Control 
Table Map (CT), which is located in the COCOS. 
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Systen or Private Volune Di nt 


01234 6 7 8 910 11 12 13 14 15 
|--|--1--|--|--]--]--1--1--1--1--l--1--]--1--1--1 
Of S$} Of O1 11 0] RESERVED | 
Jon fon |e | on | oe | one oo eon n nnn | owen eon e wenn ennnn | 
" | 
2| DISC FREE SPACE OST NUMBER (OFSDST) | 
3| DISC FREE SPACE ERROR STATUS (OFSERR) | 
4| | 


S = Seek ahead enable/disable flag 
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evi 8 Table Typical En Forna 


123 4 5 6 7 8 910 11 12 13 14 15 


0| 
| | 
1| | 
| CLASS WANE (ASCII) | 
Zi | 
| | 
3| pied | 
4] | CYCLICAL POINTER ae ee ACCESS TYPE| 
‘| OCT’ NUM’ OEVICES 
6| LDEV #1 
?| LDEV #2 | 
| cow neewnwnwecn cen en en nscoenenecnerseeesncsecnnn | 
ee a a eee 
| nS} LDEV # n | 


292220 8220 28 2688800 DP OS OOS SSSR S SSG a esoveesarn | 


The Device Class Table (OCT) contains a varying nunber of variable length 
entries. This is because you nay configure an arbitrary nunber of device 
classes on a systen, and each device class may be comprised of an arbitrary 
nunber of icgical devices. There is one DCT entry per device class, and each 
OCT entry contains a ist of logical devices an the class. There is no 
established order of e:.cries in the OCT, nor is there an order of LDEVs 
within an entry. 


Due to the Faphazard nature of the DCT, its overall preperties are kept in 
the header entry. These include the segnent-relative starting address of the 
OCT (in case the header entry shculd be expanded later) and the nunber of 
entries in the table. & s¢anent-relative pointer to the Terninal Descriptor 
Table (uhich follows the OCT) nay also te used to calculate the size of the 
OCT. Riso nete the “Entry size" word. It 18 meaningless for this table, but 
is included for conpatibility with other fixed-length entry FE tables. 


Since the DCT entries are of variable length, uhen you want a particular 
entry you must aluays start at the beginning of the OCT and link through each 
entry until you find the one you're interested in. 


Sone frelds in the OCT require further description, as foiious: 
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Dev lass Tab OCT 


Qverview of Data Seqnent 


| OST 40 (250) 
| SIR 40 (250) 


(OCT) 


(TOT) 


Header Entry Fornat 
123 4 6 7 8 910 11 12 13 14 1§ 


a OCTH’ SEGNENT’ SIZE 


| 
2{ OCTH’ NUN’ OCT’ ENTRIES | 


BD OSS OC OSS OS S @ OS OF 24S 42 2242428 £8 S2STSTS2TS8STESSBV“*HVOCS | 


af OCTH’OCT’BASE (SET TO 6) | 
4} OCTH’ NUM’ TOT’ ENTRIES | 
5| OCTH’ TOT’ BASE 
6.23.00 
13- 16 
1/0 


Word 4.( 1:7) -Cyclical pointer. Currently used only for systen and private 
volune disc devices. The pointer varies fron 1 to N (nunber of 
entries in the class) and indicates the LOEV# in the class 
list on which the last extent uas allocated. The disc space 
allocation routines will try to satisfy the next request cn 
the next disc drive indicated by the cyclical pointer (with 
uraparound to 1 if the pointer > N). If that fails, the 
pointer is increnented until space is found or all devices in 
the class have been tried. 


Word 4.( 8:1) -If set, spooling hae been enabled (speol queues cpened) for 
this device class. 


Word 4.( 9:1) -If set, the class is a terninal type class. 


Word 4.(10:6) -Usually the sane as the device type represented by the class 
0-7 for disc, 24 for tape, 32 for printer, etc.). Serial disc 
classes are disc devices accessed as tape drives, so their 
true device types are kept in the UOT, while this field holds 
a special type (31, or 237), indicating a serial 1/0 
(non-concurrent) device. Sinilarly, a foreign disc is a 
ronsharable disc drive, so that fact is reflected by a 
special type 7 in this field, even though the true harduare 
type is kept in the LOT, as for serial discs. 
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Terninal Descriptor Table Typical Entry Forna nterru nkage Table T) for HP-IB Systens 
01234 5 6 7 8 9 10 11 12 13 14 15 01234 5 67 8 910 11 12 13 14 1§ 
fent=-[--l=nl--leetoc[ontmalertecl elect |elesI eed eed Feed feed bond bad bad feed abe led ed teat ee 
| 0! 10 z0| CKANNEL PROGRAM VARIABLE AREA | ICPVAO (0 for ATP) 
| | 1{ (ICPVA) FOR TERMINALS WITH ATP J ICPVAO1 (0 for ATP) 
i 1| \1 2| DRIVERS, THIS AREA IS ZERO JICPVRO2 = (0 for ATP) 
| DESCRIPTOR FILE NAME (ASCII) | 3| |ICPVAO3 «=—s« (0: for ATP) 
| 2| 2 fon nennernneresenasasssecncerscssocnssnnsacwsnne 
| | 4| DNA ABORT ADDRESS | ICPVRO4 
| 3| \3 | |--- <--| 
| coeecweccn nnn n nc ncn nn conenerennennnencenewsoees | 5| | ICPVAOS 
| 4| \4 | penn ncen enn nnn nnn nne nnn ncernnecowesnonwesensce 
! | 6| 0 | ISROL/ICPGH 
| § IS sf ne een crcre ren conene arene [-rewnnnccne | eocoonee 
| GROUP NANE | 71 Al CHANGUE | } CHAN | DEV [ICWTRL 
6 6 fn fore necereccccnens [ores |oeceerrnece [sereeer= 
"| | 10|SYSO8 RELATIVE POINTER TO CHANNEL PROGRAM AREA | ISIOP 
7 ssf neetpen cer rcnwmnnnnnrnncorocsessoscsoenerresces 
; ‘1 cee mewn mn een en none nanan en nn newsmen nares ceeeenee | {1}SYSDB RELATIVE POINTER TO STATUS RETURN AREA  |ISTAP 
1 Gf ete teen nennmnnrennnnconcneererersoeseeanoosses 
| | (2|SINGLE INSTRUCTION THAT IS EXECUTED TO EXTRACT | IUNIT 
1 oe \9 ITHE DEVICE UNIT NUMBER FROM THE STATUS POINTED | 
] ACCOUNT NANE | 70 BY ISTAP | 
} 12] 110 [oon ne newnnnnnnn nnn cern en enn anne nn nnnnesceee= | 
| | 13|SYSDB RELATIVE DIT POINTER OF THE DEVICE jICoP 
} 13] j11 ICURRENTLY USING THE CHRNNEL TO PERFORM A DATA | 
| -ooeeoeee mowecneennsecn nnn necerecesnerenncennce | {OPERATION | 
{| 14] NUMBER OF DEVICES IN USING FILE (n) j12 | ennnewennennennnnnnece= | eonnnnnnnnnnn en no nnwnn= | 
[eseerce a a Na aaa | 14] SIOPSIZE |  CQUEN | TQUEUE 
} = 18] LDEV #1 413 eed eed ed eed ed on pS _———oe | 
lg aca eae 15|RW| WP |G|SC|SQl | HCUNIT | IFLAG 
| 16) LEV w2 14 [-= J-- |= [= [-= | oon non enneennneneee —os | 
| -onceccowweccnce eeewen cn nnevocconcorororeeeccee| id SYSDB RELATIVE OIT POINTER FOR UNIT 0 ore 
|---- PPD 0 OPO OPO DOD OS BOS BSS BS DODO DS OSB OS® seeenene2 e 
| nez14] LOEV #n inf? g$  |\|§ = [ifssuenceteenesaseseesoeesesserens lone weccccene- 
| eoonoeene soccnece ee ceneew sewer ences ccwsonneenee SYSDB RELATIVE DIT POINTER FOR UNIT n |IOITPN 


PROGRAM STATUS RETURN AREA 


The Terninal Oescriptor Table contains a varying nunber of variable length 
POINTED 10 BY ISTAP 


entries, because each Terminal Cescriptor entry nay have an arbitrary nunber 





| 
| 
of logical devices. However, you can only configure a fixed nunber of valid =| semen new nnwnnnereces= weoccoorerweconencocnce | 
terminal entry files. These are the TInn or TTPCinn files which reside in SEEKNASK (OISC ONLY) | 
PUB.SYS. SYS is one of these files. jg ©— fo [eeesuesencoeunenweeeesorconscucwsoocwosooeee o-| 
1/0 | 
PROGRAN | 
AREA | 
S898 SSS OSS 08 S58 S2EE04 4 OS SSSES SSSSSSESSSSS8SESOENSESO | 
6.23.00 6.23.00 
13- 19 13- 2 
1/0 1/0 
JLT (Cont.) vi fornation T T 
IPCVA - These four words conprise the channel progran There is cne DIT per physical device. If a physical device represents 
variable area uhere infornation is stored concerning represents nore than one logical device, the logical device nunber is 
a channel progran Interrupt instruction or abort. obtained fron the 1/0 queve elenent. Although detaile of DITs vary with 
CPVRO should be used only for channel progran aborts. device, the following structure is connon to all: 


ICPVAS - Words 4 and 5 contain DAA address, uhen channel progran 
aborts during DFA transfer. 

ISROL - Serial poll request queve length. HP-IB Systens do T for HP- 
not support any serial poll devices. This should 
aluays be zero. 














ICPGN - Thies is the SYSOB relative address of the channel progran 601234 5 67 8 9 1011 12 13 1415 
to be started for this device after receiving a HIOP jo-|-- o-oo | o= [o= | --f--[-=]--]--]--1--1--1--1--| 
interrupt in GIP. GIP will call STARTIO when the flags ©} TI] OIRCIRQISTINU| OFTO|IAIMO|STINS| STATE  |DFLAG 
uord indicates “ignore halt interrupt" and “start channel Joo |--fe-f--]--|--f--[-<f--]--|--)--|--1--1--]--1 
progran” bits are set. 1| SYSOB RELATIVE POINTER TO THE DIT FOR {DLINK 
ICNTRL - Contains controller infornation. | THE NEXT DEVICE REQUESTING | 
wf - If set, the controller is sharing a softuare | THIS RESOURCE OR SERVICE | 
channel resource in order to linit bandwidth. | coc cccwewcn renown nemewnneceneenececocoonesccco= | 
-CHNQ - The softuare channel resource funder. 2| SYSDB RELATIVE POINTER TO THE FIRST joroQP 
.ORTN - The ORT nunber for a Series 33 device is | 10Q IN REQUEST LIST | 
equivalent to: | FOR THIS DEVICE | 
.CHAN - channel nunber (4 most significant bits | eoonn nme cereonecsese sewenacereweconcccocooncans| 
of ORTN) 3| LOGICAL DEVICE NUMBER |OLDEV 
.DEV - device nunber (3 least significant bits : [seeeseeseneasseeres< eeccncconcncwscoooorosewnes 
of ORTN) 4| SYSDB RELATIVE POINTER TO DEVICE |ODLTP 
IFLAG - Used for controller flags. | LINKAGE TABLE | 
RU - Runwaat flag. An idle channel progran should | eowmowee wn cee nc eceneensceccocwooscooncoencoonen 
be started uhen there are no active requests 5| SYSDB RELATIVE POINTER TO INTERRUPT |OILTP 
to process. | LINKAGE TRBLE | 
.UP - Wastprog flag. An idle channel progran has been | eoennecccnneeenene woccene aaa | 
started for this controller. This bit is reset 6] CONTROLLER HARDWARE STATUS JOSTAT 
by an interrupt. | ponneen nnn en nae n enon cneceenoenercenenscsssornre 
.1G - Ignoreh: flag. An HIOP instruction hes been 7] HARDWARE ERROR STATUS. SET WHEN THE |OSERR 
issued against t+:s controller, but the channel | DRIVER CETECTS RN ERROR. WHENEVER § | 
progran was not in a wait statenent. Therefore, | <>0, THE DRIVER MONITOR LOGS RN | 
ignore the interrupt generated by the channel | RN 1/0 ERROR RAND CLEARS THIS UCRD | 
code when this progran halts. | eoenennnnee wocccccocococs wercceocconce 
.SC - Start channel progran flac. when set along } 10] DEVICE DEPENDENT AREA JOTINE 
with the IG flag, GIP wll start aprevicusly = tL I errr nnn nnmnnnnn enccceccee woneccowee | 
attenpted SIOP on this device. } 4 DEVICE DEPENDENT RREA jOTROX 
.$Q - Start chasnel prosrar “queved" flag. when bit Joosen | -owerewewen noes | coowocccownoreneeccenes| 
SC 18 set, this bit u:il determine if the call | 12) ror | | PHYSICAL UNIT @ |OUNTT 
to START’HPIE will heve logical paraneter |-coee | ---onn nn ncoenenne |~ore---- eo cececcocoenns | 
QUEVED true er false. 
.HCUNIT ~ Highest confioured unit nunter for this OTROX Used by sone device drivers, it denotes tiner 
controller. request index. 
6.23.00 6.23.00 
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DIT Terninology for HP-I8 Systens 


OFLAG - Device relative flags. 
T - Set af device 18 2 terninal. 
O - Set if device is a disc. 
AC - Retave bit; 1 anmplies a nonitor currently servicing 
this device. 
RQ - Request bit; 1 inplies service requested while the 
monitor 28 active. 
nU - If set, andacates device is a multiple unit 
controller. 
10 - If set, a channel progran is currently executing. 
IA - If set, an interrupt or response has occurred. 
NO - If set, device 18 in a not ready or operator wait 
state. 
ST - If set, an idle channel progran should be started 
for this device. 
SI - Special interrupt handler. 
NS - Do not short wait this disc. 
STATE - Current driver state as defined by the monitor. 
Allowable states are: 
Z0 - Start request 
1 - Not used (reserved) 
2 - Call driver anxtiator 
3 - Call driver conpletor 
4 - Not used (reserved) 
5 - Conplete request 
6 - Unexpected interrupt occurred 
7 - Start operator intervention wait 
10 - Operator wait; restart at 0 
11 - Data nakepresent/freeze wait 
12 - Initiator code nakepresent/freeze wait 
13 - Interrupt conpletion wait 
14 ~ Device controller availability wait 
15 - Not used (reserved) 
16 = Initiator code nakepresent wait 
17 - Conpletor code nakepresent wait 
DUNIT - 1/0 systen type and unit nunber. 
TOT - 1/0 Systen type: 
© - Series II/III I/0 Systen 
1 - HP-IB Systens 
2 - Unused 
3 - Unused 
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OFLAG - Flags and request state. 
AC ACTIVE - A nonitor is currently servicing this device. 
RQ REQUEST - A service request is pending uhile the noniter is 


active. 
IO IOPROG ~- An 1/0 Channel Progran is running for this device. 
TA IAK - An interrupt or response has occurred for this device. 
NO NOTRDY - Go to state 210 after Idle Channel Progran is started. 
ST STWAIT - The device monitor is starting an Idle Channel Progran 
for this device; there is no I0Q associated with this 
type of request. 
STATE - State of the device nonitor; specifies the next action 
to be taken in SION in servicing the request: 
20 - Start new request 
1 - Not used 
2 - Call driver initiator procedure 
3 - Call driver conpletor procedure 
4 - Not used 
S - Process request conpleted 
6 - Initaate device recognition sequence 
7 - Start operator intervention wait 
10 - Wait for interrupt (operator intervention) 
restart at state 0 
11 - Wait for data segnent freeze, then state 2 
12 - Wait for driver initiator to be frozen, then 
allocate controller (state 2) 
13 - Wait for 1/0 conpletion interrupt, then state 3 
14 - Wait for controller, then call driver initiator 
15 - Not used 
16 - Wait for initiator nake present, then state 2 
17 - Wart for conpletor make present, then state 3 


DLUEV - Logical device nunber. 
DUNIT - 1/0 systen type and unit nunber. 
0 - HP 3000 Series IZ/TIT 
1 + HP 3000 HP-IB 
2 - Unused 
3 - Unused 
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Device Information Table (DIT) for CIPER 


There is one DIT per physical device. If a physical device represents nore 

than one logical device, the logical device nunber 1s obtained fron the 100 

elenent (however, this driver only supports one devace per controller.) The 
following diagran shous the DIT used for the KP-18 CIPER physical driver. 
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6.23.00 
13- 24 
1/0 


DSAVE - Device processing flags. 
VS - VALID STATUS - Set to indicate Device Status has been updated. 
RB - DVRRBFLAG - Sequence Abort in progress due to ABORT request. 
RE - RETRYFLAG - Sequence Rbort in progress due to an error. 
TP - TINERPOPPED - Current error is due to software tiner popping. 
WR - NOTROYFLAG - Not Ready Wait in progress. 
NR CNT - Nunber of Not Ready Waits during this request. 
DEVICE STATUS - Device status returned during a Sequence Abort. 
BIT 8 - CRC available and enabled. 
“ 9 - Reserved. 
" 10 - Reserved. 
" 11 - Reserved. 
" 12 - Power fail or reset hae occurred. 
* 13 - A protecol error has been detected. 
" 14 - A parity error has been detected. 
* 45 - The peripheral has data to send. 


DSERR - Pointer to status to be logged. 
Bits (0:8) - Nunber of words to be logged. 
Bits (8:8) - Offset relative to DITP(O}. 


OCOUNTS - Error flags and error counts (4). 
RF - REQ FAILED - An error has forced this request to be aborted. 
UE - UNIT ERRGR ~- The current error is a Unit Error. 
DE - DATA ERROR - The current error is a Data Error. 


TO - TINE OUT - The current error is a GIC Tine Out Error. 
UNIT CNT - Nunber of Unit Errors during this request. 
DATA CNT - Nunber of Data Errors during this request. 
TO CNT - Nunber of GIC Tine Outs during this request. 
PRTY CNT - Nunber of HP-IB Parity Errors during this request. 
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QIT for Channe) Devices 
Oo 1 23 4 ; § , 6 , ? 8 9 Ra 11 or 15 
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OFLAG.TERNINAL - Device is a terninal. 
DISC - Device is a disc (Bit 0 = 0). 
.ACTIVE + A monitor is currently servicing this device. 
-REQUEST - Service requested while nonitor uas active. 
oAUNIT - Device controller servicing nultiple units. 
.SIOPREMPT - If set then a request has been queued for 
this device; preenpt code is set in 100. 
-IOPROG - I/0 progran in progress; decrenent SIOCOUNT and 
check for multi-channel when conplete. 
. TAK - Interrupt or Response has cecurred. 
-M HERD = =—s_ =: Moving head disc. 
«NT RY - Not ready for SIO; SIODN holds off next SIO until 
ALLOWPOLL is done. 
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OIT For 7905/7906/7920/7925 
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DIT for Channel Devices (Cont. ) 


OFLAG.STATE - This quantity specifies the next action to be taken 
in servicing the request. 


20 ~ Neu; start request 
1 - Not used 
2 - Call Driver Initiator Procedure 
3 - Call Driver Conpletor Procedure 
5 - Conplete request 
6 - Device recognition 
7 - Start operator intervention wat (210, 
10 - Restart request on interrupt 
11 - Wait for data to be frozen then state 2 
12 - Wait for driver code to be frozen then state 2 
13 - Call conpletor on interrupt 
14 - Wait for device controller 
15 - Not used 
16 - Wait for initiator nake present then state 2 
17 = Mait for conpletor nake present then state 3 


OLINK - SYSOB relative pointer to the OIT for the next device 
requesting this resource or service. 

br0gP - SYSOB relative pointer to the first I0Q in the request 
list for this device. 

OLDEV - Logical Device Nunber. 

DDLTP - SYSOB relative pointer to the OLT. 

DILTP - SYSDB relative pointer to the ILT. 

DSTAT - interrupt status for this device. Set each tine the 
device interrupts. 

DSERR - Hardware Oevace Controller Status. Set when the driver 


detects an error. lUhenever not zero, SIODB logs an 
1/0 error and clears this word. 
OTINE - Tineout completed flags. If a tineout occurs in response 
to a tiner request type 220 (1/0 request), the sign bit 
is set in this word. The IA bit in OFLAG is also set, 
and the nonitor for this device is auakened. (Only used 
if taner services are requested. Must be word 48 if tiner 
services are requested. ) 
OTROX - Used by sone device drivers, it denotes tiner request index. 
DUNIT - 1/0 systen type and unit nunber. 
.UNIT - Unat nunber of the physical device. 
.10T - I0 type 02 Series III 1/0; 1° HPI8 1/0 
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T For 7905/7906/7920/7 n 
| 30} HERD i SECTOR 124] 
Peete anccccccece | cocvenencccce --| > REQUEST 
{| 311 DISPLACENENT =| SYNORONE 
| 32] PATT 1 26! 
| “I PATY 2 ka 
| | PATTY 3 fe 
| 35} SECTOR COUNT TO TRANSFER 129 SCOUNT 
| 36| |30 INITADR 
| INITIALIZE RODRESS 
37] 431 
| oo-nenonnnnnnen wececraenccccnconcen=| oo} 
| ss ! L132 ONISC 
| a CONTROLLER STATUS AFTER SEEK 133 SEEKSTAT 
} 42] IN CHANNEL PROGRAM . fe 
1 43] CPVA WORD O UPON CHANNEL ABORT }35 OLOGERROR 
| 44| CURRENT LOGICAL SECTOR ADDRESS fi CLOA 
| bi CURRENT LOGICAL SECTOR ADDRESS iv 


ONISC 
(15:1) L’STAT'ERR - 1 Last transfer ended in error. 


DUNIT - 1/0 eysten type and unit nunber. 
TOT - 1/0 Devices. 
0 - Non-HP-IB 
1 - HP-I8 Systens 
2 - Unused 
3 - Unused 
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Error and Retry Infornation 


345 67 8 9 1011 12 13 14 15 


| 
Lol S} €] ni wi TL O] CicL] Oo © © Of RETRY JQRISC OF 100 
|-- 


D - Retry determination 
S$ - Request syndrone 
E - Request error information 
N= Update track nap 
W - Writing track nap 
C - Issued a recalibration 
CL - Driver issuing channel clear 
T - Tanecut wait 


NOTE: Integrated Cartridge Tape’s DIT has the sane fornat. 
cs ise Device Information Table (DIT 


There is one DIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the 100 
elenent. for the CS'80 disc controller, there will only be one device. The 
following diagran shous the DIT used by the CS'8 disc driver. 
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[ | 
ZO|TAIOSIAC|RQICO] O] OLIO[IAINO|ST| Of STATE  |OFLAG 


1| SYSOB RELATIVE POINTER TO THE OIT |OLINK 
| FOR THE NEXT DEVICE REQUESTING | 
THIS RESCURCE OR SERVICE 
7 CURRENT REQUEST INDEX eee 
3] LOGICAL DEVICE NUMBER aad 
4| SYSDB RELATIVE POINTER TO DEVICE JODLTP 
LINKAGE TABLE 
5| SYSOB RELATIVE POINTER TO INTERRUPT {OILTP 
LINKAGE TABLE 
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ST STUWAIT - The device ronitor is starting an Idle Channel Progran 
for this device; there is no I0Q asscciated with this 
type of request. 

STATE - State of the device nenitor; specifies the next action 
to be taken in SICON in servicing the request: 


ZO - Start new request 
1 - Not used 
2 - Call driver initiator procedure 
3 - Call driver conpletor procedure 
4 - Not used 
S - Process request conpleted 
6 - Initiate device recognition sequence 
7? - Start cperator intervention wait 
10 - Wait for interrupt (operator intervention) 
restart at state 0 
11 - Wait for data segnent freeze, then state 2 
12 - Mait for driver initiator to be frozen, then 
allocate controller (state 2) 
13 - Wait fer I/0 conpletion interrupt, then state 3 
14 - Wait for centroller, then call driver initiator 
15 - Not used 
16 - Wait for initiator nake present, then etate 2 
17 - Wait for conpletor make present, then state 3 


DLINK - A SYSCO relative pointer to the next OIT requesting this 
resource or service. 


OCURRECP - A current request sysbase index. 
OUNIT.(0:2) - I/0 systen type and unit nunder. 
0 - Nen-HP-18 
1 - HP 3000 HP-IB Systense 
2 - Unused 
3 - Unused 
DLDEV - Logical device nunber of this device. 
DSTAT - Set to a -1 uchen a systen peuerfail has cccurred. 
DSERR - Pointer to status to be logged: 


Bite(0:7) - Nunber of words to be ios ed. 
Bite(8:15) - Offset relative to OITP(O). 


ONISC - Device dependent processing flags. 
LOCK’FLG - Lock flag denoting unload status of the disc volune: 


© - Allow operator unload to the volune. 
1 = Deny operator unload to the volune . 


IGNORE’ INT’FLG- Ignore unexpected interrupt flag. 
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CS 80 Disc Device Infornation Table (OIT) (Cont. 


| --onnnnennecennnnonnennemnnsceneccceneneeenene 
6] OSTAT IS -1 WHEN A SYSTEM POWERFAIL [DSTAT 
| OCCURRED | 
7} WARDUARE ERROR STATUS. SET WHEN THE [DSERR 
DRIVER DETECTS AN ERROR. 
| WHENEVER <> 0, THE ORIVER MONITOR = | 
l LOGS AN I/O ERROR ANO CLEARS | 
| THIS WORD. | 
| mew eee wcewen coc cwccccwcwewecce roscoe secswcorce 
10| INDEX OF FIRST REQUEST IN QUEUE |paHERD s 
| wowccccce won conser owawowcecacoaccoscesroeoesces 
1 TNOEX OF LAST REQUEST IN QUEUE loarArL & 
| |----- wecwncweceseewcnccccce ws cwescscoccoeornes 
12{ 10T | PHYSICAL UNIT # [DUNIT 


pe ed |-n----n---- | 
ae) | SUBSTATE pore 

, ead abt pa fe STATE |RPSUORD1 
= "1 T2 ia 


DFLAG - Flags and request state. 


Th TERM - Set if device is a terninal. 

dS DISC - If Th = 0 and this bit is set then the device is 
a disc, otherwise device dependent. 

AC ACTIVE - A monitor is currently servicing this device. 

RQ REQUEST - A service request is pending while the nonitor is 


active. 
IO IOPROG - An 1/0 Channel Progran is running for this device. 


IA IAK - An interrupt or response has eccurred for this device. 
NO NOTRDY - Go to the state 210 after Idle Channel Progran is stated. 
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SUBSTRTE - Indicates state of the idle channel progran: 


© - Normal idle channel progran wait. 
1 - Idle request being serviced uait. 


DSBUFRODR - SYSOB relative pointer to the systen buffer elenent 
used to read the DSCT; zero, if no elenent gotten. 


DBADBLK1 - High order logical sector address of the bad block 
for the Defective Sector Table (OSCT) entry. 


DBADBLK2 - Low order logical sector address of the bad block for 
the OSCT entry. 


OBADXFER - Byte transfer left when bad block occurred. 
DLOGERROR - CPVA(O) logged cn hardware error status. 


DSICPSTOP - Stopped channel progran relative offeet lecation cue 
to an error in CPVA(O). 


OSTATUS - 20 bytes disc status logged on status error 
(See CS'80 Disc Drive Status). 


RPSUORD1 - Flage and local state: 


RE - Read revision code done. 
Set if read revision code level is done. 
BC - RPS revision code. 
Set if controller is "PEP"ed. 
OR - RPS desirable. 
Set if RPS is desirable. 
EN - RPS enabled. 
Set if default value for RPS is enabled. 
MR - Driver is processing a narginal data error 
fron the drive; does not retum hard error. 
Local State - State of the local request nade by driver: 


© - No local request is being processed. 
1 - Reading revision code. 
2 - Setting default RPS. 

RPSUORO2 - Default value for RPS. 


T1 - Tine to target in hundreds of nicresecends. 
T2 - Window size in hundreds of microseconds. 


DIT for 7970 Magnetic Tape 
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DUNIT - 1/0 systen type and unit nunber. 
TOT - 1/0 Bevaces. 
0 = Non-HP-18 
1 - HP-I8 Systens 
3 - Unused 
4 - Unused 


OSAVE - Device processing flags. 

Ru RWBIT - Indicates tape hae been reuound. 

RU RUUNLD - Indicates that a reuind/unload was perforned to allow a 
wurite-ring mount. 

SH SHORT - A short read is in progress; after conpletion of read, 
EOF is checked for and if not present, the requested 
bytes are transferred fron the short-read buffer to the 
user's buffer. 

CE CESTAT - Channel parity error processing is in progress. 

DC DSFLAG - Transfer used data chaining - used for conputing the 
transmission log. 

DDFLAGS - Device dependent flags. 
| R4 OOFLAGS - (bit 14) if set, need to rewind tage before next urite. 
RU DOFLAGS - (bit 15) if set, tape is rewound. 
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DIT for 7974/78 Ragnetic Tape Drives 


There is cne DIT per physical device. If a physical device represents nore 
than one logical device, the logical device nunber is obtained fron the 100 
elerent. The following diagran shous the DIT used for the nag tape driver. 


01234 5 6 7 8 $106 11 1213 1415 MNERONIC 
Poogongocgongongacgoagonsonpoogongunpoogongoctocs 
0} Of OJACIRO] OAV] OFIOIIAINOIST| O} STATE |  OFLAG 
bon gendoogongontongongontpocgengonton}ocwcoccccoes 
1| SYSDB relative pointer to the DIT for the next] OLINK 
| devace requesting this resource or service 
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2| SYSDB relative pointer to the firet ICQ in orcgP 
| request list for this device 

Qeewenese focceses coonesatsaosocosecooscoensooseonedy 

31 Logical device nunber { OLDEV 
e2envecece Geena esecesosnoe § cosecoaene i a te te lp 





ai SYSO8 relative pointer to Device Linkage Table| DOLTP 


é 2 OO COSCO COTOTOESOETZO2R®ZE eveeseeraenneaasoesoonean> 


5] SYSOB relative pntr to Interrupt Linkage Table| DILTP 


Ce a ey ee eT eeaoneuensveeragond 


6|RUIRUISH) \PF} {ECv| JPA] ODSRVE 
Gon gengwwgoogontonpoccemececcceecoccwcocccoco$ors 

7| Hardware error status. Set when the driver DSERR 
| detecte an error. Whenever «20, the driver 
| nonitor loge an 1/0 error and clears this word] 

omneimnn 


Z10| Bit 0 is set at conpletion of tiner | OTINE 
AP PD PD DDL 


9 22 98828 ©2988 268628250208. 
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Z11| Interrupt status for this unit. Set by the | OSTAT 
| driver each tine it processes an interrupt. | 
coepaocmendy 


Gecaseee SSSSE BS SES SHSASE @SSSEOD 


212 TOT) A/AAIIIIITII| Physical unit number =| (UNIT 


¢ eh 


Z13| Holds the tine cut request entry index uhile CRQST 
| a tiner is active. 
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x14] Error leg. Contains 5 valid bytes of otetus |  DLOGERROR 
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Qnisc 


601234 5 67 8 91011 12 13 14 15 
|--|--]--}o-f-- fe LeeLee onde [ode le- be l-- do! 
i | tot ot ot ¢ GRORwaro { @AacK 

| R} BI F] Gl Ef} S} Ul SPACE | SPACE | RETRY | 
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R - Retry in progress. 

B - Backspace in progress. 

F - Forward space in progress. 

G - Gap in progress. 

E - Backspace on data end-of-file. 

S$ - Short read in progress. 

U - Unload tape for wrate ring installation. 
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PUY Flags and request state 
ACTIVE - A monitor is currently servicing this device. 
na REQUEST - & service request is pending while the nonitor is 
active. 
MU UNIT - This device is on a multi-unit controller. 
10 IOPROG - An 1/0 Channel Progran is running for this device. 
IA JAK - fin inte-rugt or response has occurred for this device. 


NO NOTRDY - Go to state 210 after Idle Channel Progran is started. 

ST STWAIT - The device moniter is starting an Idle Channel Progran 
for this device. There 1s no I0Q associated uith this 
type of request. 

STATE - State of the device monitor. Specifies the next action 


to be taken in SIOOM in servicing the request: 

- start neu request 

not used 

call driver initiator procedure 

call driver conpletor procedure 

not used 

process request conpleted 

initiate device recognition sequence 

start operator intervention uait 

wait for interrupt (operator interventicn) 

restart at state 0 

Z11 - wait for data segnent freeze, then state 2 

Z12 - wait for driver initiator to be frozen, then 
allocate controller (state 2) 

213 - wait for I/0 conpletion interrupt, then state 3 

214 - wait for controller, ther call driver initiator 

Z1§ - not used 

Z16 - wart for initiator nake present, then state 2 

Z1? - wait for conpletor nake present, then state 3 


BryMHAM Sw oO 
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JOSRVE - Device processing flags 


RU RUBIT - Indicates tape has been reucund. 

RU RUUNLD - Indicates that a rewind/unicad uas perforned to allow a 
urite-ring mount. 

SH SHORT - A short read is in progress. After conpleticn of read, 
EGF is checked for and if not present, the requested 
bytes are transfered from the short-read buffer to the 
user’s buffer. 

PF POWER - Device power up indsca*ion. 

PA PENDING ABORT - An abort is pensing for a connand queued ICQ. 

FO FIRST OPERATION - The first read or urite after a rewind 

rcomnand is not ¢dzne in queuvirg noce. 

EOV End’ Of’ Volune - enatle check on 2 consecutive EOFs. 
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JOSTAT - Mag tape controller status 

BITS USE 

0 END OF FILE (EOF) 

1 BEGINNING OF TAPE (B0T) / LORD POINT (LP) 

2 ENO OF TAPE (E0T) 

3 SINGLE TRACK ERROR (NOT LOGGED FOR READS) 

4 COMMAND REJECT (REJECT) 

5 FILE PROTECT (NOT WRITE ENABLED; NO WRITE RING) 

6 MULTIPLE TRACK ERROR (ATE) 

7 UNIT ONLINE 

8 GCR (6250 BPI DENSITY) 

9 UNIT NUMBER (MSB) 
10 UNIT NUMBER (LSB) 
11 TIMING ERROR 
12 TAPE RUNAWAY 
13 REWINDING & 
14 UNIT BUSY && (REPORTED AS UNIT NOT READY) 
15 INTERFACE BUSY * 
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OFLAG - Device Flags and Request State. 

AC - A monitor is currently servicing this device. 

RQ - A service request is pending uhile the monitor is 
active. 

MU ~ This device is on a multi-unit controller. 

IO - An 1/0 Channel Progran is running for this device. 

IA - An interrupt or response has occurred for this 
device. 

NO - Not ready, start Idle Channel Progran then go to 
state 210. 

ST - The device monitor is starting an idle channel 
progran for this device. there is no 100 
associated uth this state. 


STATE - Device foritor State. 

Specifies the next action to be taken by S1GONM in 
servicing the request: 

0 - Start a new request. 

1 - Not used. 

2 - Cali driver initiator procedure. 

3 - Call driver conpletor procedure. 

4 - Not used. 

§ - Conpleted request processing. 

6 - Initiate device recognition sequence. 

7 - Start cperator intervention wait. 
Z10 - Wart for interrupt (operator interventicn), 

restart at state 0. 
Z11 - Wait for data seanent freeze, then state 2. 
Zi2 - Wait for driver initiator to be frozen, then 
allocate controller (state 2). 

213 - Wart for 1/0 conpleticn interrupt, then state 3. 
Z14 - Wait for controller, then call driver initiator. 
X15 - Not used. 
Z16 - Wait for initiator nake present, then state 2. 
Z17 - Wart for conpletor make present, then state 3. 
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DIT for 7979/80 Magnetic & DAT Tape Orives 


There is one DIT per physical device. If a physical device represents nore 
than one logical devace, the logical device nunber 1s obtained fron the 100 
array. 


7 01234 § 6 7? 8 91011 12 13 14 15 ANERONTC 
eh mahangongeegpongongowgoegon tes gostqsteetestoce 

| O] OLACIRQ| OMY] OLIOIIAINOIST] O| State | OFLAG 

| pagan dann dna dontontanton tendon tentontentootonton| 

| SYSDB relative pointer to the DIT for the next| OLINK 

| device requesting this resource or service 

| naedan tan bondwn gen dantontontententontontectonte=| 

| SYSD8 relative pointer to the first 100 in { DIOGP 

| request list for this device. | 

| eo ton bon gon dann don ton tan ton bon tontontondontnoteos | 

| Logical device nunber | OLDEV 

| pe dmn denn dnn ton dentenbonton to ntentontontentocton 

| SYSOB relative pointer to Device Linkage Table] ODLTP 

| poten ten ten don tonta-tondontentuntontontantonton 


3 
4 
S | SYSOB relatave pntr to Interrupt Linkage Table! DILTP 
6 


oS 


| patna tent nnd nn tonto tan tontontontontontondonte=| 

|RUIRU|SHIGR| |PF| JEQVIPPIIR| EI PAL OSAVE 

| on tarn don tnn ten tontentonton bon tontantontontoctes | 

| Harduare error status. Set when the driver | OSERR 
detects an error. Whenever <> 0, the driver | 


| 

| nonator logs an 1/0 error and clears this uord| 
| eben dwn ten ton gon tentontontontontoentontententoe| 
| 
| 


10 | Bit O is set at conpleticn of tiner. | OTIRE 
ee eet eet Oe ey ee eet et ot et et ot et ot ot Dk | 

11 | Interrupt status for this unit. Set by the | DSTAT 
driver each tine it processes an interrupt. | 
wegce Pere ery rey ee eee et ey oe ee oe et oe | 

92 | LOT SSAA Phys. unit # | OUNIT 


| 
| 
| 
| 
| nba ntendontontontontontontentonguntontontoctos | 
13 | Holds the tine cut request entry index while | DRQST 
| a tiner is active. | 
| --t-n tan dan ton gondontontentuntontontontoctons—=| 
14 | Error log. Contains 6 bytes of status fron =| ODEVSTAT 
te the previous operation. | 

1 
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OSAVE - Device processing flags. 

RU ~ Indicates tape has been rewound. 

RO - Indicates a reuind/offline uas perforned to allow 
a write-ring mount. 

SH - Indicates a short read is in progress. After 
conpleticn of the read, EGF is checked for and if 
not present, the data requested is transferred fron 
the short read buffer to the user's buffer. 

GR - Good retries on previcus operation. 

PF - Indicates device is pouered up. 

EQV ~ enable check on 2 consecutive ECFs. 
0 - no check 
1 - enable 
2-1 EOF read 
3 - 2 consecutive EOFs encountered 

PP - Device pouerfail processing flag. 
© - Device pouerfail process conplete. 

1 - Ist pass of device powerfail processing. 

IR - Innediate report status. 

O - Innediate report is disabled. 

1 = Innediate report is enabled. 

EI - EOF processing indicator. 

O - Last cperation was not a write file nark. 

1 = Last operation uas a write file nark. 

2 - Device buffered operations are being 
conpleted prior to issuing the second 
of a double urite file nark (EOF). 

PA - Pending abort processing. 
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DSTAT - First tuo bytes of device status. 


WORD 1 
Bit Meaning 
0 End-of-file (E0F) 
1 Beganning-of-tape (BOT)/Load-point (LP) 
2 End-of-tape (E0T) 
3 Recovered error (STE) — 
4 Connand reject 
5 File protect (not urite enabled; no write ring) 
6 Unrecovered error (NTE) 
7 Unit online 
8 GCR (6250 BPI Density) 
9 Unknown density 
10 Data parity error 
1 Tinang error 
12 Tape runaway 
13 Door open 
14 Not used 
1§ Innediate report enable 
WORD 2 
Bit Meaning 
0 PE (1600 8PI Density) 
1 NRZI (800 8PI Density) 
2 Power restored 
3 HPI8 Connand Parity Error 
4 Position Unrecovered 
§ Fornatter error 
6 Servo error 
? Controller error 
8-10 Connand Reject detail 


000 - Null code 

001 - Reserved 

010 - Device Reject 
011 - Protecol Reject 


100 - Reserved 

101 - Prior error reject 
110 = Reserved 

111 = Selftest failure 


11-15 Retry count. 
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Tf UNRECOVERED ERROR 


“- 
43 - 
4s - 


47 - 
ag - 
49 - 
§ - 
51 - 


§2 - 


' §3- 


4 - 


55 - 
57 - 
58 - 
§9 - 
61 - 


62 - 
63 - 


z 


Tape velocity uas cut of specification. 

Tape tension wuss out of specification. 

fultiple tracks were in error. Either tuo or nore 
tracks were in error for a PE or NRZI write, or tuo 

or wore tracks were in error for a GCR urite. 

Failure to verify a tape mark or density ID just written. 
Noise on detect. Indistinguishable flux transitions were 
detected while attenpting to detect a recorded block. 
Data format error. Flux transitions were found or uere 
missing in the appropriate tracks for a block detect. 
Failure to identify tape following a rewind connand 

Gap detected before end-of-data. The read fornatter 
dected a full tape width dropout within the data portion 
of a data bieck. 

Data block dropout. A full tape width dropout was 
aoe within the preanble or postanble of a data 
block. 

Redundancy check error. The read fornatter detected 
either a CRC, ACRC, LRC or residual error while reading 
or verifying a data block. 

Read parity error. The read fornatter detected an 
unrecovered parity error within a data block. For PE 
this error could include multiple tracks in error, and 
for GCR this error could also include a redundancy check 
error. (Buckhorn only). 

Abnormal connand abort, door opened (Antelope only). 
faxinun skew exceeded (Antelope only). 

Falee preanble or postanble detected (fintelepe only). 
Corrected data error on write (Rntelope only). 

Data block tineout. Could not detect the sap following 
a data block. Could be caused by a record length longer 
than the drive supportes on read. 

Tape nark dropout. A full tape width dropout uas 
detected within a tape mark. 

Tape mark unverified. A tape nark uas detected which 
does not meet ANSI specifications in terns %F Fiux 
transitions and erasure in the appropriate tracks. 

Tape nark timeout. Could not detect the gap fcllowing 

a detected tape nark. 
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WORD 3 (left byte) 


The contents of this byte contains binary coded infornation 
regarding the specific error encountered. 


If COMMAND REJECT 


5 - Oevice is write protected uhen a urite type connand was 
initiated. 

6 - Tape was mot tensioned when the command uas queued. 

7 - Write density command given but requested density 18 not 
available (option not present). 

9 - The tape to be read was unidentifiable as to fornat. 
The density read may not be available, or the tape may 
have an unreadable identifications field, or nay be 
blank 

10 - The tape to be uritten on has not been identified as to 
fornat. A write Record, Write File Mark, or Write Gap 
connand was received but cannot be processed without a 
Urite Fornat connand if the tape was unidentified at 
load point. 

11 - Drive not online. 

16 - A urate format connand was iseued but the tape isn’t at 
load point. 

19 - A backward type connand (except a reuind connand) uas 
led initiated but the tape was already positioned at 

OT. 

22 - An inproper conmand sequence was detected by the drive. 

23 - Protocol not synced. 

24 - The tape connand byte received uas unknoun to the drave. 

31 - The length of a urite record requested exceeded the 
eize of the drive’s data buffer. 

37 - Cannot urite past 10 feet beyond end-of-tape. 

40 - Door open reject. The door was opened during a long gap 
while the tape was beyond the end-of-tape narker. This 
condition 18 non-retriable to prevent unspooling of the 
tape. 
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If POSITION UNRECOVERED 


81 - Servo controller unresponsive. The servo will not take 
data fron the naster controller. 

82 - Servo failed to reach the desired state reqquested by 
the naster controller. 

83 - Serve shutdown. The servo systen lost tape tension 
unexpectedly. 

84 - Servo controller hard failure. The servo controller has 
detected a hard failure wathin itself. 

85 - Servo protocol error. An invalid byte uss received by 
the servo fron the naster controller. 

86 - A run tine error was detected by the servo. 

87 - In positien interrupt not received. Master controller 
did not get the in position interrupt it expected. 

88 - No gap detected by the servo after reading or uriting a 
data block or tape nark. 

90 - No BOT detected on load or rewind. 

91 - Speed out of specifications. 

92 - The desired state requested by the naster controller 
wae invalid for the current context. 

94 - Tape positioning failure. 


If FORMATTER ERROR 


101 - Buckhorn read fornatter unresponsive. The read fornatter 
did not respond with end ef record status after 3a data 
block was detected. 

102 - Buckhorn read fornatter harduare error. 

103 - Bad block type detected on a write operation. 

104 - Erase failure. Flux transitions were detected in a 
portion of tape currently being erssed. 

105 - No data detected after urite. 

106 - Tracks cut of syne on urite verify. 

107 - Rntelope fornatter harduare error. 

108 - Antelope fornatter unresponsive. 

110 - Fornatter byte count mismatch with data buffer. 


If CONTROLLER ERROR 


121 - Transaction ID nisnatch between comand sent to Device 
progran and the returned report. 

122 - Wo pending connand found for report received fron Device 
progran. 

123 - Invalid report nessage received fron Device progran. 

124 - Report queue overflow. 

125 - Unknown connand received by Device progran. 

126 - Connand queue overflow. 

128 - Miseing end-of-record flag in data buffer. 

131 - Byte count misnatch betueen putting a record into the 
data buffer and renoving it. 

133 - Processor handshake abort between HKP-IB interface board 
and channel progran. 

134 - Unknown HP-18 interface exception detected. 

138 = Device progran firnuare error. 

139 - Harduare utilities firnuare error. 

140 - Channel progran firmware error. 
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If COMMAND REJECT and PROTOCOL REJECT DIT for 7976 Nagnetic Tape 











{ 
| 
| 161 - Command queve not enpty. Cannot accept new tape 
| Cennand or diagnostic request. There is one DIT per physical device. If a physical device represents nore 
| 162 - Request 0SJ expected. than one logical device, the logical device number is obtained fron the 109 
| 163 - Request status expected. elenent. The following diagran shows the OIT used for the nag tape driver. 
{ 165 - Unknown unit select. 
| 166 - Tape connand secondary expected. 
| 167 - Data byte expected. 012 34 5 6 7 8 9 10 11 12 13 14 15 MNERONIC 
| 168 - Massing EOI on tape command data byte, selftest nunber, |--|--]--]e- oe bento leo london dor beol elec tecle- 
| or END connand data byte. ZO] O| OLACIRA| OU] OJTO{IAL O] O| Of STATE {OFLAG 
| 170 - Command phase protocel error for urite record. Joo |n-l-- lee len l-e leo l-- loo lec lool el ecrrre ern 
| 172 - Read record report phase protocol error. 1| SYSOB RELATIVE POINTER TO THE OIT FOR | OLINK 
| 173 - Report phase protccol error. | THE NEXT DEVICE REQUESTING THIS | 
| 174 = Cold load sequence protccol error. | RESOURCE OR SERVICE 
| 176 - END "Conplete” or “Conplete-Idle" exptected. | pence nnn n nnn nonce nen enn nnennsonnworccocscoscon= 
| 178 = END "Data" expected. 2| SYSOB RELATIVE POINTER TO THE FIRST |or10QP 
| 180 - Unknoun interface secondary connand. | 100 IN THE REQUEST LIST FOR | 
| 181 - Misplaced data byte. | THIS DEVICE 
| 184 - Interface loopback protecol error. | conn e nnn nnn nen e nnn n ewe wewenn ne msooercocnconoron 
| 185 - Run selftest protocol error. 3| LOGICAL DEVICE NUMBER {DLDEV 
| 188 - HP-IB connand parity error. —i‘“‘ié fF fe errr eer nwrr nnn nn wn nr nn nnn cen ce icra eeeccrns 
| 189 - Reset by operator during a protecol sequence. 4| SYSOB RELATIVE POINTER TO THE DEVICE |ODLTP 
190 - Device clear received. (Internal error code only.) LINKAGE TABLE | 
| WORD 3 (second byte) 5| SYSOB RELATIVE POINTER TO THE |OILTP 
| | INTERRUPT LINKAGE TROLE | 
| The sixth byte is used only when reporting transparent status of Jon foe [n= fon Jon [ne [eo nnnnnnn nnn nnn nnewneeenncces | 
| hard and soft errors while in innediate report node. When an GIRWIRU{SH| {OC(PF | OSAVE 
| innediate report urite has a soft error (retries were necessary) ff _ Iv dor tive low tontos |sereewnewncccccecwceccccccess 
| or a hard error (write failure) this byte indicates which 7| KAROWARE ERROR STATUS {OSERR 
| connand had the error. It contains the nunber of connands sent | SET WHEN THE DRIVER DETECTS AN ERROR | 
| and reported since the connand in question was issued. If the | WHENEVER <> 0, THE DRIVER MONITOR | 
( innediate reported write had a hard error, all of the connands | LOGS AN I/O ERROR AND CLEARS THIS WORD| 
| issued after the faalure also fail (they will be aborted by the co fon [oe [oo [on Jeo nn enn oon none neneseserossceocce 
| device). Thus on a hard error, this byte actually indicates the 10] BIT O IS SET AT COMPLETIGN CF TIMER | OTIRE 
| nunber of preceeding connands that failed. for non-transparent we fon |e [on | on | coon nn nn nnn nnennncceecowccocone 
| status, this byte will aluays be zero. 11| INTERRUPT STATUS FOR THIS UNIT |OSTAT 
SET BY THE ORIVER EACH TINE IT | 
| ' PROCESSES AN INTERRUPT ! 
a TOT ! | PHYSICAL UNIT # ! 
13| HOLDS THE TIME QUT REQUEST ENTRY INDEX |ORGST 
| WHILE A TIMER IS ACTIVE 
14] ERROR LOG - CONTAINS 5 VALID BYTES [OLOGERROR 
| OF STATUS | 
| ---rennnnneernnnnennnnnnnennceecewesnnenenaneen | 
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dios ; A s and request state. OSTAT - Maq Tape Controller Status 


CTIVE - A nonitor is currently servicing this device. 





RQ REQUEST - A service request is pending while the nonitor is BITS USE 
active. 
MU MUNIT - This device is on a multi-unit controller. 0 End-of-file (EOF) 
IO IGPROG - An 1/0 Channel Progran ie running for this device. 
Ia RK - fin interrupt or response has occurred for this device. 1 Beginning-of-tape (BOT) / Load Point (LP) 
NO NOTROY - Go to state 210 after Idle Channel Progran is started. 2 End-of-tape (E07) 
ST STURIT - The device nonitor is starting an Idle Channel Progran 3 Single track error (not logged for reads) 
for this device; there is no 100 asscciated with this 
type of request. 4 Connand reject (reject) 
STATE - State of the device monitors specifies the next ection § File protect (not urite enabled; no write ring) 
to be taken in SICON in servicing the request: 6 Multiple track error (RTE) 
20 - Start new request. 
1 - Not used. 7 Unit online 
2 - Call driver initiator procedure. 8 GCR (6250 BPI density) 
3 - Call driver conpletor procedure. 9 Unit nunber (TSB) 
4 - Not used. 
5 - Process request conpleted. 10 Unit nunber (LSB) 
6 - Initiate device recognition sequence. 1 Tining error 
7 - Start cperator intervention wait. 12 Tape runaway 
10 - Wait for interrupt (operator intervention) 
restart at state 0. 13 Rewinding & 


11 - Wait for data segqnent freeze, then state 2. 

12 - Wait for driver initiator to be frozen, then 
allocate controller (state 2). 

13 ~ Wait for 1/0 completion interrupt, then state 3. 

14 = Wait for controller, then call driver initiator. 

15 - Not used. 

16 - Wait for initiater nake present, then state 2. 

17 - Wait for conpletor nake present, then state 3. 


OSAVE - Device processing flags. 


RU RUBIT - Indicates tape hae been rewound. 

RU RUUNLD - Indicates that a rewind/unload uas perforned to allow a 
urite-ring mount. 

Sh SHORT - A short read is in progress; after conpleticn of read, 
EOF is checked for and if not present, the requested 
bytes are transferred fron the short-read buffer to the 
user’s buffer, 

DC OSFLUNG - Transfer used data chaining - used for conputing the 
transnission log. 

PF POWER - Device powe- up indication. 
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14 Unit busy 82 (reported as unit not ready) 
15 Interface busy * 
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1 for 9144 Cartridge tape drive 


uord 
0 


A 


10 
11 


13 
14 
1§ 


1? 


21 


22 
23 


01234 5 6 7 8 910 18 12 13 14 15 
wee gnngongongongeagonedectaotenductontostentgoctoce 
ITAJOSIACIRA} Of Of OFTOIIAINOIST] O| State | 
| nndnngnnten tendon tantontontontontuatootontantas | 
| SYSOB relative pointer to the DIT for the next| 
| device requesting this resource or service | 
| an tondnndontnntoatontontontontontuntontontangon| 
| Pointer to the current 109 | 
[anton dontnntnntantontantontontanntuntaatontooton| 
| Logical device nunber 
| en dondondentontqntontuntondontontentontootanton| 
| SYSOB relative pointer to Devace Linkage Table| 
| emdondentontontontundontamtondentuntondsotuaton| 
| SYSD8 relative pntr to Interrupt Linkage Table| 
| ow damgontontandentondontootontontootontengnnton | 
| Set to -1 when systen powerfail occurs. | 
|--dondnn dann don tontondnn ton tantontontnotangongen| 
| Hardware error status. Set when the driver | 
| detects an error. Whenever <> 0, the driver | 
| nonator logs an 1/0 error and clears this word| 
endo ndnn ton bondendentontontontentontontontontan| 
| index of first request in the queue | 
|aodon tendon dontantontontontontantondontnetonton| 
| index of last request in the queue | 
| en dnndontondantontontondoatontectontontontonta= | 
} rot | | Physical Unit @ | 
| eo tan dan dondongondantontontontootondootontortqe| 
{LXJIGIIAI | SUBSTATE | 
| -ndan ton don don tontontantontontontondectontunte=| 
| High order logical sector address of bad block| 
| -opaadondongunboendentontontnndnotontontontentan| 
| Low order logical sector address of bad block. | 
| obamdondnntondondentontontandaontontentontontes| 
| Byte transfer left when bad block occured | 
Jendun tendon gnndantandaatantnadootqotantontontes| 


| Hardware logged error status - CPVA (0). | 
[anton ton ton tontentontoctontontontontontontantes| 
| Relative offset of channel progran abort. | 


| wa hawdoe}angon}ongongoufuahos}oogucgoatonte ogee | 
| Accun byte count of transfer > 6144 bytes. | 
[oeteetondongongontontooduodgootoctontontoctootes | 
| | 
Jen dendentongentoodontontontoctoctontoctoctontos | 
| Device status (20 bytes), erroro logged | 
| wa fowgongoogcegongougvefongcogongoagoogontgoogos | 
| , 

| ewduafgengoodon}ocgowgocsoogoosoogvopongootgostos | 
| . | 
Jomtondantontondenpontontoentontondondqotontondor | 
| 


| engoegocgungoegongoegoofoesuogong cago} ocogos dco | 
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ONISC - Miscellaneous device information. 
LK - Lock flag denoting unload status of the 


device. 


ANERONIC 
OF LAG 
DLINK 


ore? 
OLDEV 
DOLTP 
DILTP 
DSTAT 
DSERR 


DQHEAD 
DQTAIL 
OUNIT 
ONISC 
DBADBLKY 
OBADBLK2 
DBROXFER 
DLOGERROR 
CSIOPSTOP 
DBYTECNT 


DSTATUS 


© - Allow operator unload of the volune. 
1 - Deny operator unload of the volune. 


IG - Ignore unexpected interrupt flag. 
In - Innediate report. 

0 - Disabled. 

1 - Enabled. 


SUBSTATE - Idle channel progran state. 


© - Nornal idle channel progran wait. 
1 - Idle request being serviced wait. 


OBADBLK1 - High order logical sector address of bad block 


encountered. 


DBADBLK2 - Low order logical sector address of bad block 


encountered. 


DBADXFER - Byte transfer left when bad block occured. 
DLOGERROR - CPVA (0) logged on harduare error status. 
DSIOPSTOP - Relative offset location of channel progran when 


error in CPVA (0) occured. 


DBYTECNT - Aecunnulative transfer count for transfers greater 


than 6144 bytes. 


DSTATUS - 20 bytes of status logged when a status error occurs. 
(Refer to CS/80 Instruction Set nanual for description.) 


ee ee SE Se + 


OFLAG - Device flags and request state. 
T 


A - Set if device is a terminal 


oS - If 1H 2 0 and this bit is set then device 18 
a disc, otherwise device dependent. 

AC - A monitor 18 currently servicing this device. 

RQ - A service request 18 pending while the nonator 
1s active. 

IQ - An I/O channel progran is running for this 
device. 

Ia - fin interrupt or response has occurred for this 
device. 

NO  - Not ready, start idle channel progran then go to 
state 210. 

ST = The device monitor 1s starting an idle channel 


progran for this device. There is no 100 


associated with this state. 


STATE - State of the device monitor. Specifies the next 
action to be taken by SIOOM in servicing the 


request: 
- Start a new request. 
- Not used. 


- Not used. 
~ Request conplete. 


NYHA Sw - oO 


- Call driver initiator procedure. 
- Call driver conpletor procedure. 


- Initiate device recognition sequence. 
- Start operator intervention wait. 


210 - Wait for interrupt (operator intervention), 


restart at state 0. 


Z11 - Wait for data segnent freeze, then state 2. 

Z12 - Wait for driver initiator to be frozen, 
then allocate controller (state 2). 

Z13 - Wait for I/0 conpletion interrupt, then 


state 3. 


214 - Wait for controller, then call driver 


initiator. 
215 - Not used. 


216 - Wait for initiator nake present, then 


state 2. 
X17 - Wait for conpletor nake present, then 
state 3. 
OLINK, 
OQHEAD, 
DQTAIL, 
DUNIT - Not used. 
6.23.00 
13- 52 


1/0 


DIT for HP9145 Cartridge Tape Orive 


word 
0 


ee ee er | 


601234 5 67 8 §$ 1011 12 13 14 15 
woo fon gowgoagongoogoctqoctungoogeogoctoctootoctoce 
JTHIOSIACIRA] Of Of OLIOITAINOIST| O} State | 
| -nguntongontootontontgontectantqntontententontan | 
| SYSD8 relative pointer to the OIT for the next! 
| devace requesting this resource or service 
[en dendwngontondonguntectwntontontantontoctentes | 


Pointer to the current 108 | 
| wo foageadoageopooposgoogoes wwf endpaagoagoogosgoe | 
Logical device nunber | 


| engendontontontuntentontontontontontontoctonter| 
| SYSOB relative pointer to Device Linkage Table! 
| nod nntontondongucgontontondmetootaentootontontes| 
| SYSD8 relative patr to Interrupt Linkage Table! 
| ongongmntentontontontambondnntontoogontontonten| 
| Set te -1 uhen systen pouerfail occurs. | 
|--dandaendontontentontentontantootuntoctentonten| 
| Hardware error status. Set when the driver = | 
| detects an error. Whenever <> 0, the driver | 
| nonator logs an 1/0 error and clears this uord| 
| en gnndnntontuntontondontuntontontontontontoctos | 


index of first request in the queue | 
wadongondonpoogongongoegontontgoctontoetentontes| 
| index of last request in the queue | 


|ondentnntondontontrntantontontentontaontontonten | 
} 107 | IAVI | Physical Unit # | 
| eopongnntontontontontontontontontontontontentas| 
JLXINRIIMIPI) (SLINP] | SUBSTATE | 
| nd an gon tondontantontontontentantontontantentas| 
| High order logical sector address of bad block| 
|-abnngantondundwotandontontantantantentontentes| 

Lou order logical sector eddress of bad block. | 
wagovagoagoa}oanguasaahoepoogvo}cogosgoogoogongce ! 
| Oyte transfer left uhen bad block cecurred =| 
| wa foogowgucgoogucgoogcogonfeefooguctgoogocgqoantgos | 
| Harduare logged error status - CPVA (0). | 
[ood tan dontuntonbentandontontontontontontanten| 
| Relative offset of channel progran abort. { 
Jon ton tan tondnndnntontontontontontentootontontes | 
|] Accun byte count of transfer > 6144 bytes. | 
| engongondontontontundantontontontentontontontes| 


Lesage etn Mad Mies ees tieel | 
| Device statue (20 bytes), errors logged | 
Jon dnn tenn dontnn tun tuntontentantontaenbontontonges| 
| used by Request Status Function 

[oo bnngonpontuntuodontontostontontmotontentontas | 





MNERONIC 
OF LAG 
DLINK 


OI0QP 
DLDEV 
ODLTP 
DILTP 
DSTRT 
DSERR 


DQHERO 
DQTAIL 
OUNIT 
ONISC 
DBADSLKT 
DERDBLK2 
DBADXFER 
DLOGERROR 
CSIOPSTOP 
OBYTECNT 


OSTATUS 





thn! 











35 


4 


bits 


bit# 


wWeeUNH HTN : 


10 
12 


bit 
6 
8 

14 

15 


DFLAG - Device 
TH 


1/0 


|onton tan tnnten ton tontontontontontontentontente=| 
1 Device Pouerfail Status (4 words) | OPFSTATUS 
| ontondondnn ton tnntontontontontontantentontontes| 


| used by the Return Pouerfail Status Utility | 
]oodondnn tendon tun tnntontontontortootontqotocton 


| 
| eogeefgonsgo 
| 
| --d--b-ode~ 
DS e 


ac 
RQ 


10 
IA 
NO 
ST 


STATE - 


ah wahochongcngongoegoagocgosgoopocgcoe | 


ehoegosgoo}oogosgucgucgongoos~ ehoaegoe | 


flags and request state. 

Set if device is a terninal 

If Th 2 0 and this bit is set then device is 

a disc, otherwise device dependent. 

A nonitor is currently servicing this device. 

A service request is pending while the monitor 

is active. 

Rn 1/0 channel progran is running for this 

device. 

Rn interrupt or response has cecurred for this 

device. 

Not ready, start idle channel progran then go to 

state 210. 

The device nonitor is starting an idle channel 

progran for this device. There is no I00 

associated with this state. 

State of the device nonitor. Specifies the next 

action to be taken by SIOOM in servicing the 

request: 

- Start a new request. 

- Not used. 

- Call driver initiator procedure. 

- Call driver continuator procedure. 

- Not used. 

- Request conplete. 

- Initiate device recogniticn sequence. 

- Start operator intervention wait. 

Z10 - Wait for anterrupt (operator intervention), 
restart at state 0. 

Z11 - Wait for data segnent freeze, then state 2. 

Z12 - Wait for driver initiator to be Frozen, 
then allocate controller (state 2). 

213 - Wait for 1/0 conpleticn interrupt, then 
state 3. 

X14 - Wait for controller, then call driver 
initiator. 

Z15 - Not used. 

Z16 - Uait for initiator make present, then 
state 2. 

Z17 - Uait for continuator make present, then 
state 3. 


VAM wo 
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DBYTECNT - Aecunnulative transfer count for transfers greater 


than 6144 bytes. 


DSTATUS - 20 bytes of status logged uhen a status error cccure. 


(Refer to CS$/80 Instruction Set nanual for 
a nore detailed description. ) 


Reaning 


0:4 Volune Nunber 
4:4 Unit Kunter 


Status Pe 


Reaning 


Channel Parity Error 
Tliegal Opcode 
Fiedule Rddressing 
Address Bounds 
Paraneter Bounds 
Illegal Paraneter 
Message Sequence 
Message Length 





The following table denotes the only valid status bits 
that can be set by Excalibur. 


WORD O : IDENTIFICATION ERRORS FIELD 


Driver Variable Nane 

OIT*FIRST* STAT’ WORD 

DIT’ FIRST’ STAT’ WORD 
nding OIT’ UNIT’ ATTENTION 


WORD 1 : REJECT ERRORS FIELD 


Oriver Variable Nane 
DIT’ CHAN’ PARITY’ ERR 
OIT' ILL’ OPCODE 

DIT’ MODULE’ ADOR’ ERR 
DIT’ ADDR’ BOUNDS 

DIT’ PARAMETER’ BOUND 
DIT’ ILL’ PARAMETER 
DIT’ ILL’ ASG’ SEQ 

DIT’ NSG’ LENGTH’ ERR 





WORD 2 : FRULT ERRORS FIELD 


Reaning Driver Variable Nane 
Unit Fault OIT’ UNIT’ FRULT 
Diagnostic Result DIT’ OIRG’ FAIL 
Powerfail DIT’ DEV’ POWERFAIL 
Retransnit DIT’ RETRANSALT 
6.23.00 
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1/0 


DLINK, 
OQHERD, 
DQTAIL - Not 
OUNIT - IOT 
RV 


In 


PI 


SL 


iP 


1/0 


Unit 


used. 
- I/0 Type. 01 for this device. 
- PVR flag. Set by driver, tested by 
SIODA. 
1 - Driver can detect unexpected 
(RVR) conditions and will exit to 
SIODM State 6 when safe. SIOOR 
should bypass State 6 when called 
fron GIP. New functionality. 
0 - Oriver cannot detect AVR condi- 
tion. SICDN should honor a State 
6 call fron GIP. Previous func- 
tionality. 
- Unit nunber for multi-unit control- 
lers. Aluays O for this driver. 


DMISC - Miscellaneous device information. 
LK 


- Lock flag denoting unload status of the 
device. 

© - Allow cperator unload of the volune. 
1 - Deny cperator unload of the volune. 
Not Ready. Renenbers the state of 
DIT’DEV’NOT’ROY the last tine status 
was read from the device. Used for 
detecting off-line transitions. 
Innediate report. 

0 - Disabled. 

1 - Enabled. 

Pending Interrupt. Set if a tape cones 
online while the driver is processing 
an I0Q in the continuator. This is 
checked before the driver enters IDLE 
in the initiator. If set, the driver 
will return unexpected interrupt up to 
SIOON. This will AVR the tape. 

Spares Lost. Set if no I0Qs are being 
processed and a pfail has occurred 

such that the spares table is lost. 

If this is set uhen the next I0Q is 
processed, that I0Q’STAT will be set 

to 2274, 

flust Powerfail Next 1/0. Set if no I/Os 
are being processed and a pfail has 
occurred such that data was lost fron 
the I/0. If this is set when the next 
100 is processed, that I0Q’STAT will 

be set to 263 POWERFRIL’ ABORT. 


SUBSTRATE - Idle channel progran state. 


0 - Nornal idle channel progran wait. 
1 - Idle request being serviced wait. 


6.23.00 
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WORD 3 : ACCESS ERRORS FIELD 


bitW Meaning Driver Variable Nane 
1 Uninitialized Media DIT’ UNINIT’ MEDIA 
2 Wo Spares Available DIT’ SPARE’ UNRVATL 
3. = Not: Ready DIT’ DEV’ NOT’ READY 
4 Write Protected DIT’ WRITE’ PROTECT 
S  Unrecoverable Data DIT’ UNRECOV’ ORATA 
41 End Of File DIT’ END’ OF "FILE 
12  €nd Of Volune DIT’ END’ OF *VOLUNE 


bit# Meaning 


aseone Seeeeeanuvoeaveces Se Gne 


0 Operator Req Release 


WORD 4 : INFORMATION ERRORS FIELD 


Driver Variable Nare 


DIT’ I'OPR’ REL’ REQ 


{ Disgnostic Req Release DIT'I’DIAG’REL’REQ 


WORDS 5,6,7, 


status bits. 
DPFSTATUS - 


7 ~—-Ruto Sparing Inveked 
11 Recoverable Data 


DIT’ DEFECT’ BLK’ SPARE 
DIT’ RECOV’ DATA 


8,9 : PARAMETER FIELD 


Refer to the CS’8O Manual for the neaning of these bytes. 
The bytes depend upon which error is reported in the 


This status is returned by the Return Pouerfail 
Status Utility after a device powerfail. It is 
valid ONLY directly after the QSTATs2 report is 
received fron the device. Do not interpret this 
status if a powerfaal has not just cccurred. 


The Utility returns 7 bytes at present, but 
4 words are set aside for it. 
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BYTEW leaning 


1/0 


0 Total Nunber of bytes returned by Utility, 
including byte 0 (currently = 7) 


Oriver V 
1 Powerfar 
Driver V 

0: 


1; 


e% 

3¢ 
2 Pouerf ai 
Oraver V. 

0: 


1: 


ariable Nane : DIT’ PFAIL’ NUN’ BYTES 


1 Status Flag 

ariable Nane ; DIT’ PFAIL’ PFSTATUS 

If no pfail has occurred 

(nedia loaded u/no pfail) 

Pfail occurred, but no tape LOA0ed 
(tape could be present or UNLOADing 
but it as not LOADed) 

Pfail occurred and a tape has LOADed 
Successfully 

Pfail occurred, tape attenpted to LORD, 
but LORD failed 


1 Data Loss Fiag 

ariable Name ; OIT’PFAIL’ DATA’ LOSS 

If no data was lost during last pfail 
Host data in buffer was not written to 


media after pfail (data lost) 


2: 


3-6 Address 
Driver V 


Spares table was not updated to tape after 
pfail (this is FATAL) 


of First Host Block Not Written 
ariable Nanes : 


DIT’ PFAIL’HOST’RDORI ... DIT’ PAIL’ HOST’ RDOR4 


If ByteW2 = 1 then this is the logical host 
block addrese of the firet block not written 
to tape after the pouerfail. 


If By 


OFLAG - Device flags 
Th 


tet2 = 0 or 2 then this will be zero. 
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and request state. 


- Set if device is a terninal 
os - If TR © O and this bit is set then device is 
a disc, otherwise device dependent. 
RC - A monitor is currently servicing this device. 


RQ 
To 
IA 
NO 
ST 


A se 
is a 
Rn I 
devi 


devi 
Wot 
stat 
The 
prog 
asec 
STATE - Stat 

acti 


ape request is pending while the nenitor 
ctive. 

/0 channel progran is running for this 

ce. 


fn interrupt or response has occurred for this 


ce. 

dat start idle channel progran then go to 
e e 

device nonitor is starting an idle channel 
ran for thie device. There is no I0Q 

ciated with this state. 

e of the device monitor. Specifies the next 
on to be taken by SIODA in servicing the 


request: 


NON & WA = © 


210 


zi1 
Z12 


x13 
z14 


z15 
X16 


z17 
OLINK, 


DOKERD, 
DQTAIL - Not used. 


- Start a new request. 

= Not used. 

- Call driver initiator procedure. 

- Call driver conpletor procedure. 

- Not used. 

- Request cenplete. 

- Initiate device recognition sequence. 

- Start operator intervention wait. 

- Wait for interrupt (operator intervention), 
restart at state 0. 

- Wait for data seqnent freeze, then state 2. 

- Wait for driver initiator to be frozen, 
then allocate controller (state 2). 

- Wait for 1/0 conpletion interrupt, then 
state 3. 

© Wait for controller, then call driver 
initiator. 

- Not used. 

- Wait for initiator nake present, then 
state 2. 

- Wait for conpletor nake present, then 
state 3. 


<<09421>> 
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T for HP35401 Cartridge Tape Driv 


| word 01234 5 67 8 931011 12 13 14 1§  MNERONIC 
| ecw don pocgengongontoobontontauotootoestectootontoce 
| 0 ITHIOS{ACIRQ] Of Of OLIO[IAINGIST] Of State | OFLAG 
| | on dendnntontondantantontentantontentantuntonton| 
| 1 | SYSDB relative pointer to the DIT for the next| OLINK 
| | devace requesting this resource or service 
| an dan ton dondon tan dantantontonta=tontentantantas | 
i 2 | Pointer to the current 100 | orcaP 
| | on pon don bn n den tondnn bon ton tomtom tan tentontontes| 
| 3 | Logical device nunber | OLDEV 
| | nn d-n nnd nn dn nbn ndnn ton tontontontontontontente=| 
} 4 | SYSOB relative pointer to Device Linkage Table| DOLTP 
| | endo ntnn ton ten ton tendontontontendnndootontontes| 
| 5 | SYSOB relative pntr to Interrupt Linkage Table| OILTP 
| | endo don dann tan ton tnntondnnbontontontonteotontns| 
| 6 | Set to -1 when systen powerfail occurs. | OSTRT 
| | oa en den den dondaontnntnntantontontoctentontontne | 
| ? | Hardware error status. Set when the driver | OSERR 
| | detects an error. Whenever <> 0, the driver | 
| ] monitor logs an I/0 error and clears this uord| 
| | oe don gon dnndnntantontantontantontontonbentontan| 
| 10 | index of first request in the queue | OGHEAD 
| ] on dnn ton ton tomtom tontentontentontontootontentan| 
} | index of last request in the queue | OQTAIL 
| | -a-dan pon den tongantnngontentontontontontontontas | 
| 12 | OT | |JAVIRC] RL | | Physical Unit # | OUNIT 
| wand mwgongangongondongontoentongoctontentendoetes | 
| 13 |LKINRJ IMJ PIIRG] LIMP] | SUBSTATE | OMISC 
| [en tangondwn penton tontontontectontentontontente= | 
| 14 | High order logical sector address of bad block] OBADBLKI 
| | aden dongengentondnntuntantontantontoctootonges | 
{ 15 | Low order logical sector address of bad block.| OBADBLK2 
| | -cdnngonqentwndaontonpuntantontontnnguodootondns| 
| 16 | Byte transfer left uhen bad block occured | OBADKFER 
| | cedaondongongontonpondentontontontontontentorges | 
| 17 | Hardware logged error status - CPVA (0). | DOLOGERROR 
| [re tondondontontontongontonteatentontootentontes | 
| 2 | Relative offset of channel progran abort. | CSIOPSTOP 
| | em ben dann dondontnngonpongendententontontootontee | 
} 21 | Accun byte count of transfer > 6144 bytes. | OBYTECNT 
| | eopongengundontongacgongontontontuntontoctonte—=| 
i 2 | | 
| | ewedongongongonpoogongongontontootontonpontenten| 
| 23 | Oevice status (20 bytes), errors logged | OSTATUS 
| | ee bnndnndmngondontondontnngontontootontontoote= | 
| | ‘ | 
| | po bontondnntontondentontootontontantootoctontes | 
| e | e | 
| | p< too de ntentontondnnganganpantontontantontenten | 

x «| : | 

| --don dona nduntontongondnntantoatontontoetectn=| 
6.23.00 
13- &© 
1/0 
DUNIT - JOT - 1/0 Type. 01 for this device. <<09421>> 
RV - AVR flag. Set by driver, tested by <<09421>> 


SIOON. <<09421>> 

1- Oriver can detect unexpected <<09421>> 
(AVR) conditions and will exit to <<09421>> 
SIODN State 6 when safe. SICON <<09421>> 
should bypass State 6 when called <<05421>> 
fron GIP. New functionality. ¢<09421>> 

0 - Driver cannot detect AVR condi- <<09421>> 
tzon. SIODM should honor a State <<09421>> 
6 call fron GIP. Previous fune- <<09421>> 
tionality. <<09421>> 

Unit nunber for multi-unit control- <<09421>> 

lers. Aluays 0 for this driver. <<09421>> 

This bit 18 the Release count bit. 

It 18 used to count how nany release 

Connands have been sent to the Merlin. 

It will eather be 30 or a i. 

0 - No release connand has yet been 
sent to the Merlin. 

1 - A release connand has ben sent to 
the Rerlin. 

This bit is to insure that ue never send 

send nore than tuo releases. 

These are the Release connand bits. 

We can send a Release to the Merlin 

fron three areas and RL keeps track of 

where Release uas sent fron. 

0 - No Release connand sent. 

1 - Release sent fron Initiator ee. 

2 - Release sent fron Continuator. 

3 - Release sent as 2a function code. 


Unit 
RC 


RL 
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a ee Cee ED Ge OP en 








ONISC - Miscellaneous device infornation. 
LK - Lock flag denoting unload status of the 
device. 
0 - Allow operator unload of the volune. 
1 - Deny operator unload of the volune. 


In 


PI 


RG 


Ld - 


Not Ready. Renenbers the state of 
DIT’OEV'NOT’ROY the Last tine status 
was read fron the device. Used for 
detecting off-line transitions. 
Immediate report. 

© - Disabled. 

1 - Enabled. 

Pending Interrupt. Oevice cane on 
line while driver was waiting on con- 
mand completion (i.e., not in idle 
CP}. On laine interrupt was used to 
complete connand, so SIODN didn't 
uake OEVREC. The interrupt also set 
this bit. If the bit is set when 
SIGON starts the idle CP, we return 
the Unexpected Interrupt state 80 
that SIOOM will wake DEVREC. 

Release Granted. Oevice requested a 
release and driver 0.K.’ed it. If 
this bit 18 set when we are ready to 
start the idle CP, we issue a status 
request CP instead. This is because 
the device does not set a DSJ of 2 
uhen completing the release due to 
conning on line! It needs an addition- 
al connand to do so. The status re- 
quest CP ensures that we finish all 
on line processing before we exit. 
Last cperation 19 a WRITE. 
fust Powerfail the next operation. 





np 

SUBSTATE - Idle channel progran state. 
© - Nornal idle channel progran uait. 
1 - Idle request being serviced uait. 
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<<Q9421 >> 
<<09421 >> 
©<09421>> 
<<09421>> 


<<09421>> 
<<09421>> 
<<09421 >> 
<<03421>> 
<<09421>> 
¢<09421>> 
<¢09421>> 
<<09424 >> 
«<09421>> 
<<09421>> 
<<09421>> 
<<09821>> 
<<09421>> 
<<09421>> 
<<09421>> 
<<09421>> 
<<Q9421>> 
<<09421 >> 
<<09421 >> 
<<09421 >> 
<¢09421>> 
<<J9456>> 
<< J9456>> 


- 
~ 
[— ] 


1/0 


DBADBLK! - High order logical sector address of bad block 
encountered. 


DBROBLK2 - Low order logical sector address of bad block 
encountered. 


DBADXFER - Byte transfer left when bad block cecured. 
DLOGERROR - CPVA (0) logged on hardware error status. 


OSIOPSTOP - Relatave offset location of channel progran uhen 
error in CPVA (0) occured. 


DBYTECNT - Accunnulative transfer count for transfers greater 
than 6144 bytes. 


DSTATUS - 20 bytes of status logged uhen a status error occurs. 
(Refer to CS/80 Instruction Set manual for description. ) 
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Card Reader DIT Fie finitions 


| ° ‘ 2 ' 3 ‘ 5, s, ? ‘ 9 ' phe 12 13 14 15 DFLAG - Flags and device state. 
| ZO} Of O[ACTIREQ] Of Of | I/OJIRK|RERD| WRi | ASTATE |OFLAG ACTIVE - Monitor is currently active servicing this device. 
| 1 ' td t GF Lf (PROG) JOONEIASG] | | ; ; ; 
| |--|-- |---| ---|--]-=]--]---- |---| ---- | ona fen} omen nee mene | REQUEST - Service for this device was requested uhile the 
1 DITP LINK TO NEXT OIT JOutN monitor uas active. 
2 ICQP POINTER TO tet REQUEST Jorogr IOPROG - SIO progran in progress. 
3] LOGICAL DEVICE NUMBER jPWeV TRK - Interrupt occurred or request aborted or preenpted. 
4| DRIVER LINKAGE TABLE POINTER |DOLTP RERDDONE - Previous read resulted in an EOF with a backup save 
wecececoc en ccncewewncewcesecernencccoosocncncsoosnscnre requested; the data has been saved in an auxiliary 
5 INTERRUPT LINKAGE TREBLE POINTER [OrLte buffer and will be passed back on the next read 
eccccecne= eo ewncewwcewenececccocecownccorconconscuscone request. 
6| (SEE BELOU) | OSTAT 
ecmer ence cece seen onsen ccecocecocerenaccssworascsoocoe NRMESSAGE - Set when a not ready message has been issued, and 
7| ERROR STATUS IF NOT O JOSERR cleared when the reader is found ready; used to 
sewcencroccococce eeececccccncccncccceceewncnnseoccocen=| prevent multiple Not Ready nessages when pouer is 
10] REQUESTED WORD COUNT [OTInE turned on. 
11| | OTRQX ASTATE - Monitor State; see SICON specifications for details. 


| eeaeese 0989288 COO OSOOOOSOGO | BES EOGEO COS CFO SEECOSOEDQOTBOSO 


12] I0T | PHYSICAL UNIT @ |DUNIT 


DLINK - SYSDB relative pointer to the DIT for the next device 
requesting service for this resource. 





DSTAT bite; 
BIT © = SIO OX 


DIOGP - SYSDB relative pointer to the first 100 elenent in the request 
list for this device. 
BIT 120 DLDEV - Legical device nunber. 
BIT 2 = Interrupt pending 
BIT 3 = Tining error UNIT - Unit nunber of device. 
BIT 4 © Light dark check 
BITS 5-6 = °° Colunn binary node DOLTP - SYSDB relative pointer to driver linkage table (DLT). 
nused 
10 Packed binary node 
11 Hollerith-to-ASCIT node 
BIT 7 = Conpare error 
BIT 8 = EOF detected 
BITS 9-10 = 00 Normal 
O1 Hopper enpty 
10 Unused 
11 Stacker full 
BIT 11 = Invalid Hollerith 
BIT 12 = Pick fail or notor check 
BIT 13 = Test 
BIT 14 = Trouble 
BIT 15 = Not ready 


OSTAT - Device interrupt status; contains the device interrupt status 
at the last interrupt (See harduare ERS for details). 


DSERR - Device interrupt error status; if not zero, then it holds the 
device interrupt status from an operation with an erroneous 
conpletion status (Causes SICON to leg an error). 


DUCNT - Holds the requested transfer count in uords. 





OUNIT - 1/0 systen type and unit nunber. 
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11{ HOLDS THE TINE OUT REQUEST ENTRY INDEX  |DRGST 
| WHILE A TIMER IS ACTIVE | 


|-ooe= 2282288800000 GOS BO2 | 600468 20208488 4E8 88280888 


Device Information Table for HP-18 Card Reader OFLAG - Flags and request state: 
AC ACTIVE - A monitor 18 currently servicing this device. 
RQ REQUEST - A service request is pending while the monitor 
There is one DIT per physical device. If a physical device represents nore 1s active. 
than one logical device, the logical device nunber 18 obtained fron the 109 fU MUNIT - This device is on 2 multi-unit controller. 
elenent. The following dsagran shows the DIT used for the card reader IO IOPROG - An I/0 Cnannel Progran is running for this device. 
driver. IR IRK - fin anterrupt or response has occurred for this 
device. 
NO NOTROY - Go to state 210 after Idle Channel Progran is 
012 3 4 5 6 7 8 9 10 11 12 13 14 15 FANERONIC started. 
Rated Rated Rated Rated Rae Sted Rated Kate ted ated Godel Gated Gated bated Gated Da ST STWAIT - The device nonator 1s starting an Idle Channel 
ZO} O} OFACIRQ] O[NU) OLIOJIAINOIST] Of STATE |OFLAG Progran for this devace; there is no 100 
Jon [on] --[--f--feo]ee feel ------l--|-------2---| asscciated with this type of request. 
1| SYSDB RELATIVE POINTER 10 THE OIT |DLINK 
| FOR THE NEXT DEVICE REQUESTING | STATE - State of the device nonitor - specifies the next acticn to be 
| THIS RESOURCE OR SERVICE | taken in SIODA in servicing the request: 
| eoewcwew nn nome cnce enc oncc corner scwccewccenoccee | Z0 - Start new request. 
ra JOQ TABLE RELATIVE INDEX TO THE FIRST |OICQP 1 - Not used. 
{ I0Q IN THE REQUEST LIST FOR THIS | 2 - Call driver initiator procedure. 
| DEVICE | 3 - Call driver conpletor procedure. 
| | eee mn ene e nnn een e meee ncceeweenennnnnneeecconn= | 4 - Not used. 
3 LOGICAL DEVICE NUNBER |DLDEV 5 - Process request conpleted. 
| | connec nn nnn eceec ee noewnse seer nseessencncssnene | 6 - Initiate device recognition sequence. 
4| SYSD8 et POINTER 10 DEVICE |OOLTP 7 = Start operator intervention wart. 
| LINKAGE TABLE | 10 = Waat for interrupt (operator intervention) 
| conn mewn cn nome cenwccc enone cowerewocrercenere | restart at state 0. 
5| SYSOS RELATIVE POINTER 10 THE |OILTP 11 = Wart for data segnent freeze, then state 2. 
| INTERRUPT LINKAGE TABLE | 12 - Wait for driver initiator to be frozen, then 
| no foe | eee nn ene en cece ence new ccwnnnnwcerecncoeoa| allocate controller (state 2). 
6IRDIAF | J|OSAVE 13 - Wait for 1/0 completion interrupt, then state 3. 
Jon Jon | conn n nen noceseeeweonnnne eewwccescoccocene | 14 - Wart for controller, then call driver initiator. 
7| HARDWARE ERROR STATUS |OSERR 15 - Not used. 
| SEY WHEN THE DRIVER CETECTS AN | 16 - Wait for initiator make present, then state 2. 
| ERROR. WHENEVER <> 0, THE DRIVER | 17 - Wait for conpletor nake present, then state 3. 
{ MONITOR LOGS AN I/O ERROR RND | 
' CLERRS THIS WORD DUNIT - 1/0 systen type and unit nunter. 
10| NOT USED | OTINE I0T I/0 TYPE - 1/0 Systen type: 
| | conn wenn een wen ewww swwenconecewnnwesocenennsens | 0 = Series II/III I/0 systen 
11] REQUEST UCRD COUNT |OUCNT 1 = HP-IB Systens 
wocce | -ooccwenennnceene | seocwcece wcoecoccccen= 2 ® Unused 
12{ TOT | | PHYSICAL UNIT # haga 3 = Unused 
13] DEVICE STATUS - READ FROM DEVICE JOSTAT DSAVE - Device processing flags. 
| DURING EACH EXECUTION OF THE | RO READDONE - A card has already been read. 
| CHANNEL PROGRAN | RF ABORTFLAG - A device clear has already been sent for 
| poncon nnn no wmn cn ce wenn ern cen cccoccocceccnccece | this series of aborted I0Qs. 
‘| LOGGING W WILL BE DONE FROM HERE een 
6.23.00 6.23.00 
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I/0 1/06 
2608 Line Printer DIT (HP-I8 Syveters) OFLAG - Flags and request state: 
AC RCT - R monitor is currently servicing this device. 
RQ REQUEST - A service request is pending while the monitor is 
There is ene DIT per physical device. If a physical device represents nore active. 
than one logical device, the logical device number is obtained fron the 100 10 IOPROG - An I/0 Channel Progran is running for this device. 
elenent (houever, there is only one device per 2608 controller.) The IA IRK - fin interrupt or response has cccurred for this device. 
follouing diagran shous the DIT used for the 2608 line printer driver. WO NOTRDY - Go to state 210 after Idle Channel Progran is started. 
ST STUAIT - The device monitor is starting an Idle Channel Progran 
for this device; there is no I0Q associated with thie 
_ 1 - ;, ‘ 5, 7 8 oe 11 12 13 14 15 MWERONIC type of request. 
ZO] Of O[ACIRA| O| Of OJIOIIA[NOIST| Of STATE [OFLAS STATE - State of the device nonitor - specifies the next action 
|--|--|--|--|--|--|--|--|--|--|--]--]-----eeeee-| to be taken in SIODN in servicing the request: 
1| SYSDB RELATIVE POINTER TO THE DIT {OLINK XO - Start new request. 
| FOR THE NEXT DEVICE REQUESTING | 1 - Not used. 
| THIS RESOURCE OR SERVICE 2 - Call driver initiator procedure. 
| eeewwewewsencnseewasnnnsesoumcese 3 - Call driver conpletor procedure. 
rd IOQ TABLE RELATIVE INDEX TO THE FIRST I0Q /OICQP 4 - Not used. 
| 100 IN THE REQUEST LIST FOR | S - Process request conpleted. 
} THIS DEVICE | 6 - Initiate device recognition sequence. 
| peeewccrcewcecescccness | 7 = Start operator intervention wait. 
3] LOGICAL DEVICE NUMBER |OLDEV 10 - Wait for interrupt (operator intervention) 
| powewcewccsereccenscsccccsotesconsenesvemseeens | restart at state 0. 
4| SYSOB RELATIVE POINTER TO THE |DOLTP 11 - Wait for data segnant freeze, then state 2. 
| DEVICE LINKAGE TRBLE 12 - Wart for driver initiator to be frozen, then 
| pon eew wenn nen ewcewencececres concresrerveresenes allocate controller (state 2). 
§| SYSOB RELATIVE POINTER TO THE {OILTP 13 - Wait for 1/0 conpletion interrupt, then state 3. 
| INTERRUPT LINKAGE TABLE | 14 - Wait for controller, then call driver initiator. 
[on | enone} eoeeenennce | ecorcnncnencennnn|oo|oo|--| 15 - Not used. 
6\vn| | TAS | [PS{FLJTPIOSRVE 16 - Wait for initiator make present, then state 2. 
| oo | eon ne | em nn wenn nnn | eo enne o|--]-- 17 - Wait for conpletor make present, then state 3. 
7| HARDURRE ERROR POINTER . |DSERR 
| SET WHEN THE ORIVER DETECTS AN } DUNIT - 3/0 systen type and unit nunber. 
| ERROR. WHENEVER <> 0, THE DRIVER | 
| MONITOR LOGS AN 1/0 ERROR RAND TOT 3/0 TYPE - 1/0 Systen type: 
| CLEARS THIS WORD © ® Series II/III 1/0 systen 
wencceceneccnccccccccceconsceccce | 1 = HP-18 Systens 
10] BIT O IS SET AT COMPLETION OF TIMER OTINE 2 = Unused 
Seedcadensecccdcocncescesescepceeccecscmeoseess 3 = Unused 


DSAVE - Device processing flags: 
vA sO VFCnOD - VFC has been nodified. 


12] TOT | } PHYSICAL UNIT @ | DUNIT TRE TREDFRULT - Systen tab default. 
sabes ecatecdscecacdaen | oscdecceseoca=nccscsesa PS PRESFACE - Last request used prespacing. 
13| HARDWARE LOGGED ERROR STATUS |OLOGERROR FL FULL - Line printer buffer is full. 
| menewennne wowccnnnenncencencecccecccccncoesonse TP TOP - Franter is at top of forn. 
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1/90 
2608 Line Printer Status 
BYTE 1 & BYTE 2: 
BITS USE 
0 On line 
1 Not ready 
2 VFC channel 9 (botton of form) 
3 VFC channel 12 (top of forn) 
4 VFC initaalazed 
5 6/8 lines per inch 
6 (not used) 
7 Power restored/unit reset 
8 On line 
§ Print mechanisn error 
10 Self test failure 
1 Paper error 
12 Self test node 
13 6/8 lines per inch 
14 Platen/raibbon error 
15 (not used) 
BYTE 3: Print node 
BITS 0-7 Node nunber 
BYTE 4: Prinary/secondary 
BITS 0-3 Secondary character set code 
BITS 4-7 Prinary character set code 
BYTE S: Self test 
BITS 0 =—r_«~Pass/fail 
BITS 1-7 Subtest nunber 
BYTE 6: 6 LPI dot row count 
BYTE 7: 6 LPI forn line nunder 
BYTE 8: 6 LPI form length in lines 
BYTE 9: 8 LPI dot row count 
BYTE 10: 8 LPI forn line nunber 
BYTE 11: 8 LPI form length an lines 
BYTE 12: Firnuare identification code 
BYTE 20: Pouer-up language 
BITS 0-3 Secondary character set code 
BITS 4-7 Primary character set code 
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OF LAG 
ac 
RQ 


STATE 


DUNIT 
10T I/ 


DSAVE 
BJ 


PS 
FL 
TP 


- Flags and request state: 
ACTIVE - A monitor is currently servicing this device. 
REQUEST - A service request is pending uhile the nenitor is 


active. 
IOQPROG - An 1/0 Channel Progran is running for this device. 
IRK - Rn interrupt or response has cccurred for this device. 
NOTROY - Go to state 210 after Idle Channel Progran is started. 
STURIT - The device monitor is starting an Idle Channel Progran 
for this device; there is no I0Q associated with this 
type of request. 


- State of the device nonitor - specifies the next action 
to be taken in SIOON in servicing the request: 
20 - Start neu request. 

1 - Not used. 

2 - Call driver initiator procedure. 

3 - Call driver conpletor procedure. 
Not used. 
Process request completed. 
Initiate device recognition sequence. 
Start operator intervention wait. 
Wait for interrupt (operator intervention) 
restart at state 0. 
11 - Uait for data segnent freeze, then state 2. 
12 - Wait for driver initiater to be frozen, then 

allocate controller (state 2). 
13 - Wait for I/0 conpletion interrupt, then state 3. 
14 - Wait for controller, then call driver initiator. 
15 - Not used. 
16 - Wait for initiator make present, then state 2. 
1? - Wait for conpletor nake present, then state 3. 


4 


on 
aoe ee 


- 5/0 systen type and unit nunber. 


0 TYPE - I/0 Systen type: 
© = Series II/TII 1/0 Systen 
1 s HP-IB Systens 
2 = Unused 
3 = Unused 


- Device processing flags: 

BETJOB - Betueen jobs fleg; if set, the Powerfail 
message is suppressed. 

REORT = Abort (caused by Foue.: “ail or Cperator) 
has occurred. 

PRESPACE - Last request used pres;acing. 

FULL - Line printer buffer is full. 

TOP - Printer is at top of forn. 
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1/0 
HP 26198 or 2613 Line Printer DIT (HP-IB Systens 


There is one DIT per physical device. If a physical device represents 
nore than one logical device, the logical device nunber 18 obtained 
fron the I0Q elenent (however, there 1s only one device per HP 2631 
controller.) The following diagran shows the OIT used for the 

HP 2631 line pranter driver. 


0123 4 5 6 7 8 9 10 11 12 13 14 15 RNERONIC 


| | 
20| : ee 01 O| cia alta O| STATE {OFLAG 
| SYSDB RELATIVE POINTER TO THE OIT J OLINK 
| FOR THE NEXT DEVICE REQUESTING | 
| THIS RESOURCE OR SERVICE — | 


| 
2| 10Q TABLE RELATIVE INDEX TO THE FIRST jD10QP 
| 10Q IN THE REQUEST LIST FOR | 


—_ 


| THIS OEVICE : 
1 LOGICAL DEVICE NUMBER ‘ebadad 
4| SYSOB RELATIVE POINTER 10 THE |OOLTP 
| DEVICE LINKAGE TABLE | 
S| SYSDB RELATIVE POINTER TO THE {OILTP 
INTERRUPT LINKAGE isda cies | 
6| ocd i iP 


| HAROWARE ERROR STATUS | 
| SET WHEN THE DRIVER DETECTS AN | 
| ERROR. WHENEVER <> 0, THE DRIVER | 
| MONITOR LOGS AN 1/0 ERROR AND | 
| CLEARS THIS WORD | 


| 
10| BIT 0 IS SET AT COMPLETION OF TIMER |DTINE 


| 
11| HOLDS THE TINE QUT REQUEST ENTRY INDEX = |ORQST 
| WHILE A TIMER IS ACTIVE | 


| 
PHYSICAL UNIT #  |OUNIT 
|OLOGERROR 
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0123 4 5 6 7 8 9 10 11 12 13 14 15 


DIT O10 {0 JACIRQIO JO |SPICPIIAINRISW] | STATE {OF LAG 


| POINTER TO NEXT OIT |DLINK 
ol ingen To ACTIVE 100 OR ZEROS 100 
| wk Iwi a= “lise 
al pRaveR LincnGe TABLE POINTER (DUTP 
s|“InTeRnup? LINKAGE TABLE POINTER {rete 
| "SpectaL EAROR CONDT}IONS TO BE LOGGED [stat 
|e ee oR sean 
1 aor | taneouT Inpicatzon IN gro *dTIe 
| af OTTERER Request INDEX (IRL) OR ZERO (TRU 
1 oaekaor tL PmvSTCAL UNIT w [DUNT 
| 43) RENT DATA URITE evi CONT locecwr 
| ot OmeT AnD OM | peuct 
| ashe OF boas LEFT TO Teaser cat 
| 46 BUFFER OFFSET FOR NEXT w OF UORDS TO NFER (DOFFSET 
7h we ove. EB EDDEBUS 
| aol E70 SiATUS BLOCK UORD 1 GEIS *Loc@uFFER 
| LOGGED FROM HERE | 
| oat ae Status sock wo aces 
| LOGGED FROM HERE i 
1 of Tap sas mee onostar 
| (16 WORDS, SEE OCEFINITION) | 


| | SOS OO O8SC SO COS SSS 2SE4O48 2888 22498246 £288 OSSES8SEE8S088 | 


OF LAG - Device relative flags: 
AC - Active bit - 1 implies that a monitor is currently 
servicing this device. 
RQ - Request bit - 1 inplies service requested while the 
monztor is active. 
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SP - SIO preenption - if set, then a preenptive request 
has been queued for this device; the preenpt code is 
set in the 100 elenent. 

CP - Channel progran in progress - if set, then a channel 
progran is currently executing. 

IR - If set, an interrupt or reepense has occurred. 

WR - If set, the device 18 in a not ready or cperator uait 
state. 

SU - If set, an idle channel progran should be started for 
this device. 

ASTATE - Current driver state as defined by the monitor; allouable 
states are: 

ZO - Start request. 

1 - Not used (reserved). 

2 - Call driver initiator. 

3 - Call driver conpletor. 

4 ~ Unused (reserved). 

5 - Complete request (perhaps retum to user). 

6 - Unexpected interrupt occurred. 

7 - Start operator intervention wait. 

10 - Waiting (on operator) - restart at 0. 
11 - Wasting (data nakepresent/freeze). 

12 - Waiting (initiator code nakepresent/freeze). 
13 - Waiting (for conpletion interrupt). 
14 + Waiting (for device controller availability). 
15 = Unused (reserved). 

16 - Waiting (initiator code makepresent). 
17 + Warting (conpletor code nakepresent). 


OUNIT - I/0 systen type and uns nunber. 
IOT - I/0 systen typ 
© - HP 3000 Series II/III ($IO/DI0) 
1 - HP-IB Systens 
2 - Reserved 
3 - Reserved 
OCBCNT - Current byte count to be transferred. 
DCUCNT - Current word count to be transferred. 
ORCNT - Renaining word count to be transferred. 
DOFFSET - Offset in buffer of next nunber of uords to transfer. 


DOEBUG - If bit 15 = 1 then debuaging information will be sent 
to the console. 


DLOGBUFFER - Status uords 1 & 3 are moved here to be logged - if 


they were logged fron the 1/0 status block their 
contents might be changed before they were logged. 


DIOSTAT - I/0 status area (16 words) - see I/0 status block 
definition. 
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INP Device Infornation Tab] T ont. 


01234 5 6 7? 8 9 10 11 12 13 14 15 


26| PRRAMETER 2 (Or2R2) (dOUTP2 
or} Seno binloe COUNTER CS 
| RECEIVE DzALOG COMERS |ORECY 
ul oMESSReE SENT’ AT BER {peor 
xl ND | ReSSAGE FROM InP TYPE. [DIKNSG 
ail acauest DEMIR Ge \OrNrD 
xa} ERROR CODE. LET] en] STATUS. [ORSTATUS 
35] iw COUNT wee ee aie psn |DINCNT 
1 mae 
37) pRAMETERss—s—“‘(a‘(C~;C;*;<‘<;<S;S;7;«C;S | STRPARN 
aol Taace nasov RESTS COUNT IDTRCNT 


| 
41] EXTERNAL TRACE EXTRA DATA SEGMENT KUNBER |ODSTN 


42| RESERVED | CUT MSG TYPE AT ERROR [DERROR 
a3] REQUEST IOEWTIFTER (1008) | 
44| PARAMETER 1 (QNISC) | 
a 
‘acim 
i mana loser 
sol Ite pivten at Tine oF EeRoR ‘ns 


Si[TP|PHY ORVR VERSN ® [Ml | LOGICAL ORVR VERSN @ = |DVERSION 


§2| RESERVED | IN ASG TYPE AT ERFOR [OERRORI 


st REQUEST IDENTIFIER (16QX) 
S4| ERROR CODE rt ia STATUS | 
55{ IN COUNT 
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NP Devi nfornetion Table T 
01234 5 67 8 91011 12 13 14 15 


eelensjee!]eaf[ee|eo| eo oo foo |--[--[-- eeloee enf-- 


| | 
OTTO] O JACIROITI] O[PRITOJINISMIMANSTATE| IOSTATE|DFLAG 


41| POINTER TO NEXT DIT [OLINK 
a a 
3] LOGICAL DEVICE NUMBER |OLDEV 
‘Meee loouP 
g| INTERRUPT LINKAGE TABLE POINTER {pret 
Iie, <  S lostaTus 
| ""Sartuane THneR REQUEST IMEX rau 

| rolsulmul HARDUARE TIRER REQUEST INDEX (33) [OTINE 

i urge ee ee | 

S gue | 

| a3) "Renpy QUEUE HERO POINTER | penova 

| a Rav ae COMES | 

| ash vaeTIve QUEUE MEMO POINTERS | acriveo 

| tl Me ORE TEL 
17|"" WAITED QUEUE HERD POINTER "t arteog 


WAITED QUEUE TAIL POINTER 


| 
| 
| 
| Z21[EO|UP|TR| PFSTATE [UFPRINRISD} OS | — |ABIDSTATE 
| 
| 
| 


22] RESERVED | MESSAGE TO INP TYPE {OGUTASG 


| 
23] REQUEST TOENTIFTER (100x) |OOUTIO 


| 24| PRRAMETER 1 (anzsc) |DOUTP1 
| 25] OUT COUNT {DOUTCNT 
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WP Devi nforn n Tab Tt nt. 
2345 6 7 8 9 10 11 12 13 14 15 


[eed pea Pd ed bes bo ped be oo DDD 
56] TRANSMISSION LOG 


8 SOO SO OC 6 OS O888C8OSE8 CBSO8SS OSE OS SE GESDSESSSSSTESTOESE | 








57| PARAMETER | 
60| DRIVER ERROR CODE onal ORVRERR 
1} ROMEO ERROR COE meee 
| 2\NRRDUARE ERROR STATUS | STO PROGRAM INDEX IDSERR 
| ga, TOOTHPICN HRADURRE ERROR STATUS CTP reRROR 
1 oat | 
| 6st oniven Twice RENO TOU TEX ———‘doverrom 
| ol NED aad 
| 62, OSTw FOR PORT TRANSLATOR” TRAKOSTH 
| OL PLABEL FOR PORT TRANSLATOR CUDTRAWPLBL 
; nl te tonne oot ste ie orsiz 


INP DIT Field Oefinitions: 

OF LAG - Flags, IOSTATE and MANSTATE. 

-ACTIVE - If set, the Oriver is active servicing this device. 

REQUEST - If set, service for this device was requested uhile the 
Driver uas active. The Driver is run again to insure 
servicing of the condition which caused REQUEST to be set. 

.DO’ TIMING - If set, the harduare end eoftuare tiners are started in 
the normal manner uhen perforning an cperaticn. If clear, 
no tining is done. 


. STOPREENPT- ileh dike request queued by ATTACHIO. Not used by this 
river. 


-IOPROG «= >:«If set, an 1/0 pregran is in progress. Set by STARTIO and 
cleared by GIP. Not used by the Driver. 


- IRK - Interrupt Acknculedge. If set, an interrupt has cccurred or 
@ softuare taineout has conpleted. 
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SIMULATOR - If set, all I/0 is to be sinulated. The Driver will set 


MAMSTATE 


 IOSTATE 


DLINK 


DICQP 


DLDEV 
DOLTP 


UNFRZ 


flags in the ORT instead of calling STARTIO. 


- Menory Manager State. 


.PASSREADS - 


.NOTROVUATT- 


. SENDING 


GPENSTATE - 


ABORT 


0 - Null, no Menory Managenent requests or condition. 

1 - Not used. 

2 - Data segnent associated with the first request in the 
Active Queue is being nade present and frozen. 

3 - Data segnent associated with the first request in the 
Active Queue is frozen in nenory. 

4 - Data segnent associated with the second request in 
the Active Queue is being nade present and frozen. 
Inplies the data segnent associated with the first 
request is frozen. 

5 - Data segnents associated uith the first and second 
requests on the Active Queue are frozen in nenory. 

6 - Not used. 

7 - Not used. 


Current 1/0 progran operation being perforned. 

0 - Inactive. No I/0 1n progress. 

1 - Idle Read. The Idle Read 1/0 progran has been started. 

2 - Sending nessage. fin I/0 progran uhich sends a nessage 

without data and then goes to the Idle Read section 

of the 1/0 progran has been started. 

Sending data. fn I/0 progran uhich sends a nessage 

and data and then goes to the Idle Read section has 

been started. 

4 - Send nessage and interrupt. Rn 1/0 progran uhich 

sends a nessage without data then interrupts and 

halts uhen the nessage sent has been started. 

Send data and interrupt. An 1/0 progran which sends a 

nessage with data then interrupts and halts has been 

started. 

6 - Receive data. An 1/0 pregran uhich sends a nessage 
and receives data then interrupts and halts has been 
started. 

7 - Do not start 1/0. Used to hold off requesting any 1/0 
activity during a power on reset or when an error 
occurs. 


> 
6 


Link word for the linked list of devices waiting to be served 
by the I/0 process associated with this device. 


Systen DB relative pointer to the first elenent in the request 
to be processed list for this device. The requests are queued 
to this list by ATTRCHIO but 1m processing, they are noved 

to other queues depending of the state of the request. 

the Driver aluays attenpts to keep this list enpty. 


Logical Device Nunber of this device. 


Systen 08 relative pointer to the Driver Linkage Table (OLT) 
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2 - Power failure detected on the Nainfrane before INP 
has indicated a power failure. Wait for IKP to 
indicate a power failure. 

3 - Power failure indicated by INP before being informed 
by the Mainfrane pouer failure routines. Wait for the 
Rainfrane power failed request. 

4 - Power failure indicated both on the Mainfrane and by 
INP. Power failure recovery nay be started. 

5 - Send Redo. The Mainfrane receive count was less than 
the INP send count so the dialog must be restarted. 

The Driver is sending the Redo nessege. 

6 - Send Ignore. The Mainfrane eend count was greater than 
the INP receive count so any part of a dialog so far 
received is to be asters and the entire dialog will 
be retransnitted. The Oriver 18 sending Ignore nessage 

7 - Recovered. The Mainfrane and INP dialog counters 
agree or Mainfrane not sending, so no recovery is 
necessary. The Driver is sending the recovered 
nessage informing INP to go back to its normal node. 


If set, the source data segnent is to be unfrozen uhen 
the data has been transmitted to the INP. If clear, 
the source data segnent renains frozen until a request 
conplete indication is returned by the INP. 


If set, then read requests are to be passed arcund other 
requests which have been inpeded because no buffers are 
available on the INP. 


If set, then a request has been inpeded because no buffers 
were available on the INP. 


If set, an I/0 progran which sends a message, with 
or without associated data, hae been started but not 
conpleted. 


Operational state of the Driver and INP. 

0 - Not opened or closed. 

1 - In ROM. The device has been opened but the RAN 
Cperating Systen has not been entered. 

2 - Crashed. Sone catastrophic error has occurred. 

3- In RAN. The device has been opened, down loaded, and 
is in the RAM Operating Systen. 


If set, one or nore requests have been aborted but the 
abort was not done because the aborted request was in the 
process of doing a Menory Managenent function or 1/0 uhen 
request to abort uas processed. The actual abort will 
take place uhen the Menory Nanagenent function conpletes. 
Message type code for nessages sent to INP. 

Request identifier associated with the nessage being sent. 
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1/0 


OILTP 
DSTATUS 


OTRLX 


OTINE 
. TIMED 
RERDYO 


RERDYQTL 


ACTIVE 


ACTIVEQTL 


WAITED 


WAITEDOTL 


DSTATE 


-ERRORONLY - 


WRAP 


. TRRCEON 


.PFSTATE 


7/0 


COUTPI 
DOUTCNT 
COUTP2 
DSERD 


DRECV 


DEOT 


DINNSG 
DINID 
ORSTATUS 
DINCNT 
DXLOG 


DINPARM 


DTRCNT 


DOSTN 


DERROR 


=< A SS CS AES ow 


Systen DB relative pointer to the Interrupt Linkage Table (ILT) 


Controller hardware status. Set by GIP on interrupt and the 
Physical Oriver during certain service operations. See INP 
ERS for description. For the Toothpick version, this word 
contains the software tineout flags as described for the uord 
OTINE below. 


Timer request index for software tineouts as returned by the 
PE procedure TINMEREQ. 


Timed out flags and type 3 driver process PCB Nunber. 
If set, a softuare tinecut has conpleted. 


Systen DB relative pointer to the 100 for the first request 
the Ready Queve. If zero, the Ready Queue is enpty. 


Systen DB relative pointer to the last 100 in the Ready 
Queue. When the queve is enpty, this word points to the 
word preceding then queue head pointer in the DIT. 


Systen DB relative pointer to the 100 for the first request 
the Active Queve. If zero, the Active Queue 1s enpty. 


Systen 0B relative pointer to the last I0Q in the Active 
Queve. When the queve is enpty, this word points to the 
word preceding then queve head pointer in the DIT. 


Systen 08 relative pointer to the I0Q for the first request 
the Waited Queue. If zero, the Waited Queve is enpty. 


Systen DB relative pointer to the last I0Q in the Waited 
ueue. When the queve is enpty, this word pointe to the 
uord preceding then queue head pointer in the DIT. 


Driver state and control flags. 


If set, the Driver trace record is to be returned to the 
Trace Process only when an error occurs. 


Tf set, the Oriver will overlay the oldest trace entry 
when a trace record overflow occurs. If clear, entries are 
lost when an overflow occurs. 


If set, the Driver trace facility is enabled and the Driver 
seers trace entries for nost of its local subroutine 
calls. 


Power failure recovery state. 

0 - No power failure recovery in progress. 

1 - Powerfailure detected on the Mainfrane before INP 
indication. Check for conpletion of any pending 1/0 
and then wait in PFSTATE 2 for INP to PFAIL. 
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Paraneter cne of the nessage being sent to INP. 
Count paraneter of the nessage being sent to INP. 
Paraneter tuo of the nessage being sent to INP. 


essages sent counter. This word contains the nunber of 
nessages sent since the RAN Operating Systen was entered. 
It is used for power failure recovery. 


Ressages received counter. This word contains the nunber of 
nessages received fron INP since the RAM Operating Systen was 
entered. It is used for power failure recovery. 


End of dialog flag. When a nessage has been sent and the 
EOT indicating INP has received the nessage is transmitted, 
is received into this word. This flag is used to indicate 
the Logical Driver that a transnission has been completed 
and the Physical Driver should be called to check the 
completion status and update the IOSTATE. 


Nessage type code of message fron INP. 
Request Identifier associated with nessage fron INP. 
Request Conpletion status. 


Nunber of bytes of data to be received associated with the 
conpletion of a request which results in data being sent 
fron INP, 


Transmission log to be returned uhen the requez* identified 
by DINID is conpleted. 


Peranete” associated with the conpletion of this request. 
This «ord is returned in the X register by IOSTATUSX. 


Trace ready pendirg count. This word contains the nunber of 
Trace Peady nestages received but not satisfiec by Trace Ready 
requests. 


If not zero, then internal Driver extra data segnent tracing 
1s enabled and this is the deta segnert muster into which the 
trace entries are to be set. 


Driver Error block. The following sixteen words are used to 
etore infornation describing the current operations being 
perf.rmed when a catastrophic C-.ver error occurred. & 
Catastrophic error eccurs on iliccical Oriver control data, 

RPE errors, or when inP does not respond in an errected nanner. 
The first Five-vord block is used ts held the current 

or las* message transmitted to INP uhen a catsstrophic error 
Concatscr was dete.ted. It contains the data in the sane forn 
as messese tu aN? block. 
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T/0 


OCSERR - C$ Error Code associated with a catastrophic Driver error. 


DSAVE - Request Identifier of the request being processed uhen a 
catastrophic Driver error was detected. 


OVERSION - Version nunbers of the Physical and Logical Drivers. 

TP - If set, the Physical Oraver is for the Toothpick Systen. 
-PVERSION - Physical Driver version nunber. 

.LWERSION - Logical Oriver version nunder. 


DERROR1 - The six-uord block beginning here is used to hold the last 
nessage received fron INP before a catastrophic Driver error 
was detected. It contains the data in the sane fornat as the 
nessage Fron INP block. 


DORVRERR <= Holds the code specifying the catastrophic error detected 
by the Physical Driver. See ERRORS under the PHYSICAL DRIVER 
INTERNAL SPECIFICATIONS for the definition. 


DANTRERR - Holds the code spect ying the catastrophic error detected 
by the Logical Driver. See ERRORS under the LOGICAL ORIVER 
INTERNAL SPECIFICATIONS for the defanation. 


DSERR - Hardware Controller status when a catastrophic Driver error 
was detected. 


-HSTATUS - Left byte of the DSTATUS uord at tine of error. 


 STOPX - SIO progran area relative index to the last order executed 
or current order being executed at tine of error. 


OTP’ERROR - Toothpick hardware error status. To be defined. 


DTR’IOQX «== ~*If not zero, then an IOQP pointer to the Trace Read request 
which 18 supplying the locked and frozen buffer into uhich 
the Driver places trace entries to generate a trace record. 


DTRANDSTN - OSTN for port translator. 
DTRANPLBL - PLABEL for the port translator. 
DITSIZE + INP controller DIT size. 
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WORD 2 - Reserved (unused). 


WORD 3 - ACS fault nunber - contains an integer describing the 
last fault to occur since the last tine the I/0 status 
was read or the HP 2680R/2688A uas powered down; if the 
word is zero there is no ACS fault (see OCS ERS for a 
description of the ACS fault nunbers). 


WORD 4 - bit = 0 - (CL) no roon for attenpted character set load. 

1 - (FL) no roon for attenpted forn load. 

2 = (VL) no roon for attenpted VFC load. 

3 - (CU) attenpt to print data and there is no 

currently selected character set. 

4 - (FU) attenpt to select an undefined forn set. 

5 - (VU) attenpt to print data and there is no 

currently selected VFC set. 

6 - (IL) attenpt to print data and there is no 
currently selected logical page table (LPT) 
entry. 

(IP) attenpt to nove pen off the logical page. 

(ST) the 2680R/2688A could not process all of 

the data before it was supposed to be 

transferred to the drun/paper - data uas lost. 
§ - (SB) spooler block contains fornat error. 

10 = (IR) invalid recovery block received fron 
the spooler. 

11 - (MP) naxinun nunber of copies per physical page 

has been exceeded - this is a result of the 

spooler process setting the naxanun copies per 

page with function code 132. 

(NJ) a connand or function code uas received 

when no "JOS" was in progress - the connand or 

function was ignored by the OCS. 

13 - (NN) no memory - 26808/2688A dynanic nenory 
allocation has detected that main nenory is 
conpletely occupied with character sets, VFCs, 
forns and data such that the 2680A/2688A cannot 
process the current input data - data will be lest. 

14 - (TL) attenpt to print data and there ere nore than 
the maxinun allowable Logical Page Table (LPT) 
entries selected. 

15 - (NC) a non-existent VFC channel uas skipped to. 


oo~ 
¢o¢8 


12 - 


WORD § - BIT = 0 - (LP) logical page truncated to fit physical page. 
1 - (PF) page size required by progranner did not 
match page size set by operator - operator page 
size prevails. 
2 - (NC) no character set selected. 


WORD 6/13 - Feserved for future use (unused). 
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1/90 
0 Sta ik 
12345 67 8 91011 12 13 14 15 OIT 
| ola tee “oR oF uneos 1718 75 LGERTED eRe” [nz 
( eC \n22 
; geese cao 123 
| “sl mee emWR 28 
+ atcatettvctcateabvutac tae {+ |etzetnetaa amt relncizes 
- ee Ree 
aap eee =u tee? 
i was w= = ~~ CCC x30 
b Ao meee teat 
if ae ee me 1232 
| ec un te33 
f geet “a in34 
| oul Recon wns OF ER 1235 
\- IF uORD 4 IS - 
| 15] NON-ZERO |Z36 
| sgl ageT MUNGER OF ERROR IF LORD aS (x37 
|- NON-ZERO OR LAST SHEET TRANSFERRED -| 
] 17] IF "JO8" AND POWER ARE ON |Z40 


WORD 0 - Each bit is the 'OR’ of one word in the table (except 
bit 0 which is not used); bit .(1:1) is set if word 1 
in the table is non-zero. 


WORD 1 8 - bit = 0 - (OF) online/offline bit. 

1 - (NS) neseage being displayed on the 2680A/2688A 
console. 

2- tee pouer up completed since last I/0 status 
read. 

3 - (PE) parity error detected cn PHI connand. 

4 - (TE) transmission error detected in the printer. 

5/15 - Reserved (unused). 
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WORD 14/15 - The record nunbder which contains the offending error 
ae defined by word four - if a poner fail occurs during 
a "JOB", the pouer fail bit is set and a sheet nunder is 
nade available in uords fourteen and fifteen; houever, 
the record nunber is lost and cannot be reported (these 
words occur in a “JO08" only). 


WORD 16/17 - The sheet nunber on which the error occurred as defined 
by word four - if an error occurs in the environnent file 
at the start of a “J08", then this nunder will be zero; 
additionally, when a pouer fail occurs during a "JOB", 
the pouer on bit is set in word one and the sheet 
nunder of the last successfully transferred page is 
placed here (this infornation is for use by the 
spooler should a recovery of a "JOS" be determined - 
these words occur in a “JOB only). 


All words of the 1/0 Status are cleared whenever the status block 
is returned to the host. It is up to the host CPU to retain any 
ongoing status bits required. 
QNISC - Miscellaneous request dependent storage available to driver. 
1234 5 6 7 8 9 10 11 12 13 14 15 
Joe |a- foe foo] oe|-=f--]--|--fee|--l--l--1--1--l-- 
1093/M8|RB(AB}IG| 70) | MFER | PARITY |Qnrs¢ 
|--|-- feof -- |= |---| eo | -- | ----e nen loool -- 
.(0:1) - (NB) user requested a transfer in excess of 4096uords; 
the driver can write up to 4096 words to the 2680A/2688A. 
In order to handle up to 32K words, multiple writes are 
used without a return to the user uho called the driver. 
This bit indicates that multiple writes are being done 
to the 2680A/2688A. 
(131) - (RB) the current urite block must be retried. 
.(2:1) = (AB) user requested abort in progress flag. 
.(3:1) - (10) I/0 status has been read and is available. 
.(4:1) = (10) general 1/0 controller tines out. 
-(5:4) - Reserved (unused). 
-(9:3) - (KFER) 26808/2688A transfer error counter. 
.(1233) - (PARITY) channel progran cennand parity error counter. 
-(15:1) - Reserved (unused). 
A2NOTE**In the above exanple, single bit fields are as defineo 
uhen the bit is a logical "1". 
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Disc Request Table and Disc Requests Dise Request Table 
Requests for disc transfers are effected by acquiring an entry fron the Disc | DISCREQTRE OST = S& (%70) 
Peaueit Table (DISCREQTRB), filling the proper information, and calling the DISCREQTAB PRT = 21017 
DISCOMANAGER to lank the request into the device's doubly linked request 


oer Disc Request Table Entry 0 Fornat 
The head and tail of a device’s request queue are contained in the 
devices’ DIT. 





0123 4 5 6 7 8 § 10 11 12 13 14 15 
Peed ees ed eed ed ed es oe eee | 


DISCREQTAB DISCREQTRBOO | TOTAL ENTRIES 


Pa ENTRY SIZE (221) 


DISCREQTRBO2 | PRIMARY ENTRIES 























| 
| 
| 
| ee eed | DISCREQTABO3| INPEDED PROCESS PCB 
|------| | Lepeicess 0, a wD at OT ec or Ota ate oer age 
| |----/ | CURRENT | DISCREQTABOS | TABLE INDEX OF HERD OF AVAILABLE 
| OIT ra REQUEST | | ENTRY LIST 
ence) | [eeeneeene enw enenmernnaseressasonenccoesooscce 
acvove rt tt | DISCREQTABOS| © TABLE INDEX OF TAIL OF AVAILABLE 
oe | | | ENTRY LIST ! 
oe || OL DI cS GC CS 
lt | | Sterne MAX ENTRIES IN USE ! 
tit AE SNM ce ac 
oe | | DISCREQTABO7 | CURRENT ENTRIES IN USE 
Pry Cieesewsee fe ee een eM a en a ee Sato 
|} \-->] FIRST | eel DISCREQTABIO| OVERF LOWS | 
| | REQUEST | ea eae | 
| | IN QUEUE |<>----\ | OISCREQTAB11 | { 
[saveccnesues | | TOTAL REQUESTS | 
| | | | | OISCREQTABI2| ! 
| | | ae rehash AN OE Cen re Pa ae cae ee ae cat any banger on 
| | | | | OTSCREQTAB13] SYSBRSE INDEX OF KEAD OF DISABLED REQ Q  |OISCQHERD 
t | a, | EOE aco pose eceeann-peaie rai 
j ae --| ] | DEES SYSBASE INDEX OF TAIL OF DISABLED REQ Q |DISCQTAIL 
| | NEXT a EOP SA RSA 
| | REQUEST | | DISCREQTAB1S| SERIAL WRITE QUEUE HEAD | SERUQHERD 
| | IN QUEUE |<>----\ [ee [eo enneoneotenresr (sSasser— sees rare iat 
| | eoewnnnnen oe | | | OISCREQTABIE|A | | MAX. SERIAL WRITE QUEUE i" = Active 
| | | | SOL Se ane re ee 
| eases! | | | OISCREQTABI7| | 
| | LAST | <r-0-e/ we neeenncecnnn enon eewernenenennenenwseweosooens | 
\----->] REQUEST | | DISCREQTAB20| | 
| IN QUEVE | | cone nnn ene cn errno nn nnnnnnnnescoccococcwcnrsos --| 
Jonneeenennne| 
| | 
| | 
| | 
|-n----------| 
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1/0 1/0 
Disc Request Elenent Fornat Uord 0 - QFLAG - Request dependent flags. 
Bit O .ABORT Request has been aborted externally. 
Bit 1 .AMREQ Request is for a segnent transfer. 
0123 4 5 6 7 8 9 10 11 12 13 14 15 Bit 2 .OIAG Diagnostic request (not used). 
|--1--|--|--1--1--|--]--l--1--1--!-- 1-1 --1--|--1 Bit 3 .SBUF Systen Suffer. Target is a systen buffer 
Word OO/A IN (DIS Iz $B Ic JO im ja is [P (Cc (O IL Iz} uhose index is relative to the start of 
j8 in |Z (8 JO IK jo JA IM JU IX IF JU IT 1D Im | the SBUF table. 
jo [IR |A JU du JO Im IT JE JE 10 JA IR IS IR IL | Bit 4 .IOURKE Wake caller on conpleticon of request. 
IR JE IG IF JA] IP IR IR IU IF IT IR IAL 10} Bit § .BLOCKED Blocked 1/0. Caller is waited in ATTACHIO 
Iria} | WK L CIR JE IR ILE 18 EF Ic | until request is conpleted. 
ridd db bbb t itt dado tht Bit 6 .CONPLETED Request has been conpleted and caller auoken 
Pret bt tbe bb tb tbe t te . if he had specified. 
| ewan nen ne enn wenn ween ewww nneeewonnnnneoennccene= | Bit 7 .DATAFRZN Data segnent has been nade present and is 
Word 01] REQUEST URGENCY CLASS |URGCLASS frozen. 
| penn nn nn nn ew enne nnn cone enennncenecnncncowocronen| Bit 8 .MAMERRORD MAN error on data segnent nake present. 
Word 02] LOGICAL DEVICE NUMBER esas Bit 9 .PREQQUEVED Request is queued into disc’s request 
aoocewecccone coccce rer enncweccsnoecoccceeweeece queue. 
Word 03) MISCELLANEOUS nIsc Bit 10 .SFAIL Start SIO failure in GIP. 
[on | oon ennncnccen cn ewe cower eseccnccnconnwoecones Bit 11 .PFAIL The 1/0 has been aborted because of a 
Word 04) S| DST (IF PROCESS DISC I/0) |DSTN powerfail. 
| o-|-- --|S = Stack Bit 12 .CURREQ Request is device’s current request. 
| BANK (IF SEGRENT TRANSFER) Bit 13 .DISABLED Request is disabled. 
meeewesoccnmn renee ecemenencnscenseccscnrecewene Bit 14 .LOR Request in logical ORQ. 
Word 05| OFFSET INTO DATA SEG (IF PROCESS DISC 1/0) |ROOR Bit 15 .INLOCAL Buffer OST is in process locality. 
ADORESS IN BANK (IF SEGHENT TRANSFER) | Word 2 - QLDEV.QLDEVN - Logical Device Nunter. 
Word 06] UNIT @ FUNCTION | FUNC Word 3 - QNISC - Device dependent. 
Word 07| COUNT/XLOG/CONTROL RETURNS |XFERCNT Word 4 - QOSTN - If SYSBUFRs is clear then this is the DST nunbder 
cecccowoc on enoweresnccsoosrene wcocenne| of the target data segnent. If bit 0 is set then buffer 
| Word 10} P1 (KOOR IF SEGHENT TRANSFER) | PARI address is a 08 offset value instead of sega relative 
-- wen ennnwn ncn nce nonce nmnewneseoeneenne| offset (inplenented for NOWAIT I0 and NOBUF). 
| Word 11] P2 (LOOA IF SEGHENT TRANSFER) |PRR2 
| | eeenew wee conecnecncewss | encenecccerer=|-nnconne| Uord 5 - QRDOR - Offeet in data segnent or sys buff table to target 
ord i | QUALIFIER | STATUS [STAT data buffer. 
Word 13/FR| PCB KUMGER |PCON Word 6 - eee - Function code and qualifiers es specified by 
oe | eeonweweconeeecce eee cwenenecroowocnesennenns river. 
| Word 14) INDEX OF PREV REQUEST IN QUEUE | PREVREQP 
| Word 15] INDEX OF NEXT REQUEST IN QUEUE ence 
| Word 16] | 
J- SEGIDENTIFIER (IF SEG TRANSFER) -|SEGIOENT 
| Word 17] ! 
| Word 20} DISPLACENENT GF RERD OR URITE | SEGDISP 
! FROM SEG BASE (RN) 
Note: Upon return to free list, uord (#1) becones index of next EE free 
entry. 
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Word 7 - QXFERCNT - On initzation specifies the word count if positive veue (10Q) Table Layout 
or the byte count if negative. At conpletion of the request 
this lecaticn contains the actual transmission count in the 
sane units as the original call. Certain control requests | cow wnnnnnwnee nn nnne enn nnnenne l 














retum data through this locaticn. I TOTAL # ! 
Word 10 - QPAR1 - Paraneter one, defined by driver. \ " ENTRY SIZE 
Word 11 - QPAR2 - Paraneter two, defined by driver. a PRIMARY # 
rd 12 - 3] INPEDED PROCESS PCB } 
OSTAT.QUALIFIER - A code which further defies or qualifies the | teen nen enn nn nce cen nnn ennnee | 
general status. Defined by the driver. [-----4| HERD INDEX | THEAD 
QSTAT.STATUS - General status. Indicates current and result | | eoee wn nnn n conn nn ner eer cennene | 
state of the request according to the following 4 wooee | TAIL INDEX ee 
Codeee oe ne A REE RS SSR CSTE tee 
© - Not started or awaiting conpleticn. | | 6] MAXIMUM OF IN USE — | TUSE 
1 - Successful conpletion. | | | pow newer nn cen nn nme meeeennenn- 
2 - End of file detected. | | 7| CURRENT IN USE | 
3 - Unusual condition. | ] ewan ween ene cowereeneneennce 
4 - Irrecoverable error. | ot OVERFLOWS Ai 
Word 13 - QPCEN.PCEN - PCB Nunber of process uhich nade this request | } 444 | 
Zero if not associated with any process and | | | TOTAL REQUESTS | TROSTS 
10Q is to be returned by the systen. | | 12| 
| enwcececcweswascecowocecacceese 
Word 13 - bit 0 = 1 - Q elenent is on free list. | | i UNUSED | 
ee ee es 
NOTE: See I/O Systen Status Returns later in this chapter. | | 7 
| | t 4 INDEX OF 5 Jo----\ 
ee ee | | 
| ; | | ; | 
| ; til i 
| | | | ENTRY 1 i | 
| l tf ; | 
| ; ti ; | 
| | | [owen enw enneneennnnnnnewncconn { | 
\roee> J---[->| [<-eo]----\ 
[Pal saetenesseesececssssessecexs ; ft I 
i tl 0 ee | 
[i Oh: [eseeenenseteeraeesancoeeacoss , | 4 
1 i | ; | 4 
ft f | ; | 4 
; id ENTRY 2 ; tot 
1 |i ; | ol 
; til i It | 
| | Jrceweccercenennnnceneccoconce ; {| | 
\so- |=] ; tf 
| [ecceecnnnncccccecccecennnerne| | | 
\--| INDEX OF 1 | | | 
i 
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T/0 1/0 
Ta n 1/0 Queve Elenent (109) 
as | | 0123 4 5 6 7 8 9 10 11 12 13 14 15 
| oy peel bod cd Bd od oo es bd ed do 
ENTRY 3 | ol REQUEST DEPENDENT FLAGS QF LAS 
| ! | J 100 POINTER fQLINK 
| 2| OLDEVN JQLDEV 
| INDETERRIMATE | . MISCELLANEOUS janzsc 
“ls | DATA SEGEENT DST NUMBER oe 
| ENTRY 4 | | | 5| ADORESS {QADOR 
| (IN USE) Poof ff Ince tnecenennenennnnnns | ceemnorecnscseees o---- 
| i UNTT & | FUNCTION {QFuNC 
eae era | 7| COUNT /KLOC/CONTROL RETURNS |QUBCT 
Cnn) En) (a) hci a nad ee oe Des ewoosonue 
| INDEX OF 2 |-ooeeoenn/ meeeee cnn ccecec nce. cocenwcennnenenenccsonsocese 
| | aeeer sae ee cecwees c2e0e | 200 eoeeesere ene! wsene2eenn 
| | 12| | QUALIFIER | STATUS JOSTAT 
ENTRY § | Jew fewer er eewesenncocen Jonnocsoecce i=] saesesee 
{ | | 13|FRI PCEN |QPCBN 
| | |-=[------=- weenennnne sone ene 
OF LAG - Request cependent flags: 

Bit 0 -REGRT - Request has been aborted externally. 

Bit 1 SPECIAL - Special handling is to be applied to this 
request; for diec, indicates a nenory 
nanagenent request. 

Bit 2 .019G = Diagnostic request (not used). 

Bit 3 .SBUF - Systen Buffer. Target is a systen buffer 
whose index is relative to the start of 
the S8UF table. 

Bit 4 .IQURKE - Wake caller on conpletion of request. 

Bit 5 .BLOCKED - Blocked 1/0. Caller is waited in ATTACHIO 
until request is conpleted. 

Bit 6 .COMPLETED - Request has been conpleted and caller aucken 

Af he had specified. 

Bit 7 .DATRFRZN - Data segnent has been nade present and is 
frozen. 

Sit 8 .ARNERROPD - MAN error on data segnent nake present. 

Bit 9 -PREG - This request has been started but uas 
preenpted by a ARN request. 
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Bit 10 .SFAIL - Start SIO failure in GIP. 
Bit 11 .PFAIL - The I/0 has been aborted because of a 
pouerfail. 
Bit 12/13 .PREENPT - Preenptive type code: 
1 - soft 
2 - hard 
Bit 15  .MSGDONE - A ressage request reply has conpleted. 


QLINK - Table relative index of next I0Q element; points to first 
word of elenent. 


QLDEV - Logical Device Nunber. 
QNISC - Miscellaneous request dependent storage available to driver. 


QDSTN - If SYSBUFRs is clear then this is the DST nunber of the target 
data segnent; if bit 0 is set then buffer address is a 0B offset 
value instead of segnent relative offset (inplenented for 
NOWALT 10 and NOBUFF) - S(Uord 4(0:1) - Stackflag - If set 
is 08 relative. 


QADOR - Offset in data segnent or systen buffer table to target data 
buffer. 


QFUNC.FUNC - Function code and qualifiers as specified by driver. 


QUBCT - On initiation specifies the word count if positive or byte 
count if negative; at completion of the request this locaticn 
contains the actual transmission count in the sane units as the 
call (Certain control requests return data through this 
location). 


QPAR1 - Parameter one, defined by driver. 
GPRR2 - Paraneter tuo, defined by driver. 


QSTAT - .QUALIFIER - A code which further defies or qualifies the 
general status; defined by the driver. 

QSTAT - .STATUS - General Status. Indicates the current and resulting 
state of the request according to the following codes: 
© - Not started or auaiting conpletion. 

1 = Successful conpletion. 
2 - End-Of-File detected. 
3 - Unusual condition. 

4 - Irrecoverable error. 


QPCBN - .PCB - Nunber of process which nade this request; zero if 
not associated with any process and I0Q is to be 
returned by the systen. 


Word 13 bit 0 - Queue elenent is on free list. 
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1/0 
Systen Status n 
STATUS Z 
4 - Irrecoverable Error 

0 - Invalid request 4 
1 - Transnission error 14 
2 - I/0 tineout 24 
3 - Tining error 4 
4 - SIO failure 44 
5 - Unit failure 54 
6 - Invalid dase address 64 
7 - Tape parity error 74 
11 - Paper tape tape error 114 
12 - Systen error 124 
13 - Invalid SBUF index 134 


14 - Channel failure, tineout or no response fron 144 
the controller 


15 - Uninitaalized media (LINUS) 154 
. 16 - No spare blocks availeble 164 
17 - Deleted record detected on IBN floppy disc 174 


20 - Labeled device unavailable after reel switch 204 
21 - Parity error detected on PHI connand (EPOC) 214 


STATUS % XLOG 


S§ - Error In Data Control Information 


0 - Invalid iten nunber § 
1 - Invalid access for iten 15 VALIO ACCESS 
2 - Faislure in FOPEN or FREAD 25 FS ERROR NUMBER 
3 - Parity change in & bit nude 35 
4 - Invalid infornation file fornat 45 
5 - Checksun error in information 
file 
6 - Paseed value less than 
nininun 65 MIN. VE@LUE ALLOWED 
7 - Passed value greater than 
naxinun 75 MAX .VALUE ALLOWED 
10 - Passed value is unsugecrted 105 
11 - Count less than required to 
return all infornataon 115 WIN. SPACE NEEDED 
12 - Count sreater than available 
for storing infornation 125 MAX. SPACE AVAIL 
13 - Passed values not in ascending 
order 135 OFFSET OF ELEMENT 
14 - Passed character has other 
defined function 145 OTHER FUNCTION 
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1/0 Systen Status Returns 


STATUS % 
© - Pending 
1 - Waiting for conpletion 10 
2 - Doing error recovery 20 
3 - Not ready wait x» 
4 - No urite ring wait 4 
5 - New paper tape uait 50 
1 - Successful 
0 - Normal 1 
1 - Read terninated uith special character 11 
2 - Tape retry for success required 21 
3 - Low tape or end-of-tape after urite 31 
2 - End-Of-File 
1 - Physical end-of-file 12 
2 - Data 22 
3 - End-of-data 32 
4 - HELLO 42 
5 - BYE 52 
6 - JOB 62 
7 - End-of-job 72 
3 - Unusual Condition 
1 - Terninal parity error 13 
2 - Terninal read tined cut 23 
3 - 1/0 aborted externally 33 
4 - Data lost 43 
5 - Data set not ready or disconnect, 53 
or unit not online 
6 - Aborted because of power fail 63 
7 - BOT and BSR, BSF request 73 
10 - Tape runaway 103 
11 - EOT and write request 113 
12 - No urite ring after request to cperator 123 
13 - End-of-tape ister tape low) 133 
14 - Plotter linit switch reached 143 
15 - Enable subsyeten BREAK and no CONTROL Y PIN 153 
16 - Read tine returned overflow 163 
17 = BRERK stopped read 173 
20 - Write and no card in wait station 203 


21 - Device powered on - cperating environnent lost 213 
27 - VFC has been reset 27 





6.23.00 
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1/0 
ueu nent for 7976R netic Tape 
lotentect 3, 45 s, ? ae 13 14 15 ANEMONIC 
Z0| REQUEST DEPENDENT FLAGS _ 
1| SYSOB RELATIVE POINTER YO TKE Toa {QLINK 
| NEXT I0Q ELEMENT - POINTS 10 THE | 
| FIRST WORD OF THE ELEMENT 
| ae pitas rib JQLDEV 
3{ Ri Bt FI a TOUT] FSCNTR ! BSCNTR [| RICNTR |GNISC 
. | |QOSTN 
§| OFFSET IN THE DATA SEGHENT OR SYSTER |QROR 
! BUFFER TABLE TO THE TRRGET DATA | 
BUFFER | 
| | FUNCTION CODE | QFUNC 
|QUBCT 
10} PRRAMETER 1 - USED ONLY FOR REROS {QPAR1 
CONTAINS THE EOF SPECIFICATION | 
IN BITS (13:3) 
i PARANETER 2 - USED ONLY FOR URITES |QPRR2 
| IF BIT (13:1) IS SET, URITING | 
PAST EOT IS ALLOWED | 
* QUALIFIER | STATUS em 
13] PCB NUMBER | 


2888S OOO S CS E8 8 G8 OS 8 O88 9GSS889 8 22S SS28ESE8ES6 COSEOECE® | 


QFLAG - Request dependent flags: 

Bit © RBORT ~ Abort this request and return an error 
indication to the caller. 

Bit 1 SPECIAL - Apply special handling to this request (unused). 

Bit 2 DIAG - This is a request fron the diagnostic subsysten 
(unused). 

Bit 3 SYSBUFF - Target is an index relative to the SBUF Table of 
the data buffer. 

Bit 4 IOWRKE - Wake caller on conpletion of request. 

Bit § BLOCKED - Blocked 1/0. The caller is waited in ATTRCHIO 
until the request is conpleted - inplies IOURKE. 

Bit 6 COMPLETED - The request has been conpleted and the caller 
auakened if he had requested (uith IQUAKE). 

Bit 7 OATAFRZN - Set by the nenory nanagenent routines (NAN) when a 
MRKEPRESENT request is successfully conpleted and 
indicates the data segnent is frozen in nenory. 
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Bit 8 MANERRORO - An error has cccurred uhile MAM uas trying to ueue Element (10Q) for CIPER 
make the target data segnent present and freeze 
it in menory. 








Bit 9 PREO - Unused. 01234 5 6 7 8 91011 12 13 14 18 ANERONIC 
Bit 10 SFAIL - Delayed failure of SIO instruction - if a call to J--|--[--|-=]--[--J--f--|-<1--]--f-- leet --l--1-- 
START’ HPIB resulted in the request being added to 20] REQUEST DEPENDENT FLAGS |QFLAG 
the channel queue, this bit indicates that the SI0 | | ewneeenen nen ennennccrcccnnnennennnnceeneenn= o--| 
instruction failed when the request uss selected 1| T0Q TABLE INDEX TO THE NEXT IOQ ELEMENT  |QLINK 
for executicn. | POINTS TO FIRST WORD OF ELERENT 
Bit 11 PFAIL - The request uas aborted because of a systen power | coon nnn ewcnnenennec nnn eesecewnerencnsconcnences | 
failure. x LOGICAL DEVICE NUMBER {QLDEV 
QOSTN - If QFLAG.(3:1) is clear then this is the DST nunber of the 3| [QnIsc 
target data segrent - if S is set, QRODR 1s 08 relative. [x] Semem sera stsesasnsaeseneacesesenneneescusces 
4| S| |QOSTN 
QNISC - Driver request dependent flags and counters - used nostly for lp a igh 
error retries. 5| OFFSET IN THE DATA SEGRENT OR SYSTEN |QRDOR 
R - Indicates an error retry is in progress. | BUFFER TABLE TO THE TARGET OATA BUFFER| 
8 - Backspace record processing for an error retry is in | conn wn ee nnn nnn wennew ene | coerennennsneorecorennn 
progress. 6| | FUNCTION CODE FOR |QFUKC 
F - Forward space record processing for an error retry is i l THIS REQUEST =| 
in pregress. |[rownwencneenonee wooeeee J eeweccetennnnnenneenece 
G - Gap processing for an error retry is in progress. 7| |QUBCT 
80 - Backspace record due to a data EOF processing is in | pan ee enon en ne nnn nee rn sw en ennorsccnoceroreccne | 
progress. 10] PARAMETER 1 {QPAR1 
TOUT - GIC taned-cut counter. | mewn weno nnn ecw ecco wmoc renew wnweennnonensore | 
FSCNTR - Forward space record counter. 11] PARAMETER 2 [GPAR2 
BSCNTR - Backspace record counter. | eoeewe nw nner cwewnen ene | eoneennnnnenne | -------- | 
RICNTR - Error retry counter. ia QUALIFIER |RSTATUS ert 
QUBCT - On initiation, specifies the word count (> 0) or byte count 13] PCEN jaPce 
< 0) - at completion of the request this location contains | cocec eww nnnweccwenwennenerewcocccoccecnnnnwnene| 
the actual tranenission count in the sane units (bytes or 
words) as in the request. 
QFLAG - Request dependent flags: 
QSTAT - PCB nunber and request conpletion status. Bit © ABORT - Rhort this request and return an error indication 
PCEN - The Process Control Block (PCB) nunber of the process to the caller. 
uhich nade this request - if zero, the request is not Bit 1 SPECIAL - Apply special handling to this request (unused). 
asscciated with any process and the I0Q elenent is to Bit 2 DIAG - This 18 a request fron the diagnostic subsysten. 
be returned by the systen uhen the request has conpleted. Bit 3 SYSBUFF - Target 18 an index relative to the SBUF Table of 
STATUS - General status indicating the final state of the the data buffer. 
request - the following codes are used: Bit 4 ICURKE - Uske caller cn completion of request. 
0 - Not started or auaiting conpletion. Bit 5 BLOCKED - Blocked 1/0. The caller is waited in ATTACHIO 
1 - Successful conpletion. until the request is completed; inplies IOQWRKE. 
2 - End-of-file detected. Bit 6 COMPLETED - The request has been conpleted and the caller 
3 - Unusual, but recoverable, condition detected. auakened if he had requested (with IOURKE). 
4 - Irrecoverable error has cccurred. Bit 7 DATAFRZN - Set by the nenory managenent routines (MAN) uhen a 
QUALIFIER - A code which further defines or qualifies the MAKEPRESENT request is successfully conpleted end 
eneral status (see the section Driver Return indicates the data segnent is frozen in menory. 
tatus Codes cn the next page). Bit 8 MAMERRORD - An error has cccurred while MAN was trying to 
make the target data segnent present and freeze 
it in nenory. 
6.23.00 6.23.00 
13- $9 13- 100 
I/0 1/6 
Bit 9 PREQ - (Unused). CIPER Driver Return Status Codes 
Bit 10 SFAIL - Delayed failure of SIO instruction; if a call to 
STARTIO resulted in the request being added to 
the channel] queue, this bit indicates that the SIO General Status (13:3) Qualifying Status (8:5) Qveral) (8:8) 
instruction failed hen the request unas selected 
for execution. © - Pending 1 - Waiting For Conpletion z10 
Bit 11 PFAIL - ete igaas uss aborted because of a systen pouer 3 - Not Ready Wait p & 8) 
ai ure. 
1 - Successful 0 - No Errors z1 
QOSTN - If GFLAG. (3:1) is clear then this is the DST nunber of the 
target data segnent; if S$ is set, QADOR is 08 relative. 2 - End-of-File (Unused) 
QUBCT - On initiation, specifies the uord count (> 0) or byte count 3 = Unusual Condition 3 - Request Aborted 2133 
(< 0); at completion of the request this location contains 6 - Powerfail Abort x63 
the actual transmission count in the sane units (bytes or 221 - Device Powered Up 2213 
words) as in the request. 
4 - Irrecoverable Error 0 - Invalid Request x4 
QSTRT - PCB nunber and request conpletion status. 1 - Transfer Error z14 
PCEN - The Process Control Block (PC8) nunber of the process 2 - 1/0 Timed Out Before Complete 224 
which nade this request; if zero, the request is not 4 - SI0 Failure 244 
associated with any process and the I0Q elenent is to § - Unit Failure 254 
be returned by the systen when the request has conpleted. Z12 - Systen Error 2124 
RSTATUS - General status indicating the final state of the 214 - Channel Failure 2144 
request - the following codes are used: 221 - Parity Error 2214 
0 - Not started or auaiting completion. 
1 - Successful conpleticna. 
2 - End-of-file detected. 
3 - Unusual, but recoverable, condition detected. 
4 - Irrecoverable error has cecurred. 
QUALIFIER - A code uhich further defines or qualifies the general 
status (see the section Driver Returr. Staivs Codes 
cn the next page). 
P- R Physi river R C 
QPERATION FUNCTION PRRANETERS 
RERD 0 = None 
URITE 1 None 
FILE OPEN 2 ~—s None 
FILE CLOSE 3. = None 
CEVICE CLOSE 4 # None 
CIPER INIT 184 None 
6.23.00 6.23.00 
13- 101 13- 102 


1/0 1/0 


2608 Line Printer yeu nent (HP- gtens Bit 8 RANERRORD - An error has occurred while MAN was trying to 
nake the target data segnent present and freeze 
it in menory. 





12 34 5 6 7? 8 91011 12 13 14 15 ANERONIC Bit 9 PREQ - (Unused). 
ee ed ee feed nd ea pes bed od ped ee de | Bit 10 SFAIL - Delayed failure of SIO instruction; if a call to 
20| REQUEST DEPENDENT FLAGS {QFLAG STARTIO resulted in the request being added to 
eo nnwwwnn cn cnw ee nnwe ns cercconcooeocccoccoence - the channel queue, this bit indicates that the SIO 
1| SYSDB RELATIVE POINTER TO THE NEXT IOQ | QLINK instruction failed when the request was selected 
| ELEMENT ~ POINTS TO FIRST ELENENT | for execution. 
| | come n en en nen en wn nnco enn ecncnressewonrscoccnownn | Bit 11 PFAIL - The request uas aborted because of a systen power 
ra | LOGICAL DEVICE NUNBER iaunev failure. 
| Jon oo lon | eoccrens | core rer ett rererns | corerreene- 
3|PP|PE|NC| TOUTCNTR| | WAITCODE |QNISC QNISC - Driver request dependent flags and counters 
J--|--|--|---ee-e= | eoerwoenowowwcene | oweweennnne | PRE'TO'POST - Pre to post spacing change flag. 
4| S| |QDSTN PEJECT - Last cperation was a page eject. 
| co | oem nen n mewn cen n meses aceccsescnconcccsornces | MASTERCLR - Master clear done to clear powerfail bit in status, or 
5| OFFSET IN THE OATA SEGMENT OR SYSTEN {GABOR Master clear needs to be done fron not ready condition. 
| BUFFER TABLE TO THE TARGET DATA | TOUTCNTR - Channel tine-out retry counter. 
| BUFFER | WAITCODE - Indicates type of wart: 
| eowecennecowceneccescns | pone owen conn ew wecoccnnn | 0 - New request. 
6| | FUNCTION CODE FOR |QFUNC 1 - Completion wait. 
| THIS REQUEST 2 - Not ready wait. 
7! |Quact QDSTN - If OFLAG.(3:1) is clear then this is the DST nunber of the 
| poner nn en nc ener onsen reereeeosercwcnscocscweee ! target data segnent; if Sis set, QROOR is 0B relative. 
10| PARAMETER 1 |QPAR1 
oe cen seen en en nn cenescceococrecsererweserowwnn - QUBCT - On initaation, specifies the word count (> 0) or byte count 
114 PARAMETER 2 |QPAR2 (< 0); at conpletion of the request this location contains 
| eoccennencnnnncccserooe |oooeenoeceesee | -------- | the actual transmission count in the sane units (bytes or 
12] | QUALIFIER | STATUS {QSTAT words) as in the request. 
13] PCB NUMBER |QPCEN OSTAT - PCB nunber and request conpletion status. 
| eonwwcnnmcewoccccce sence eewcecccnccccnccooe cone] PCBN - The Process Control Slock (PCB) number of the process 


uhich nade this request; if zero, the request 18 not 
associated with any process and the 10Q elenent is to 


QFLAG - Request dependent flags. be returned by the systen when the request has conpleted. 
Bit © ABORT - Abort this request and return an error indication STATUS - General status indicating the final state of the request; 
to the caller. The following codes are used: 
Bit 1 SPECIAL - Apply special handling to this request (unused). © - Not started or awaiting conpletion. 
Bit 2 DIRG - This 18 a request fron the diagnostic subsysten 1 - Successful conpletaon. 
(unused). 2 - End-of-file detected. 
Bit 3 SYSBUFF - Target is an index relative to the S8UF Table of 3 - Unusual, but recoverable, condition detected. 
the data buffer. 4 ~ Irrecoverable error has occurred. 
Bit 4 IOWRKE - Wake caller on conpletion of request. QUALIFIER - A code uhich further defines or qualifies the general 
Bit S BLOCKED - Blocked I/0. The caller 1s waited in ATTACHIO status (see the section Driver Return Status Codes 


until the request is completed; inplies IOWRKE. above). 
Bit 6 COMPLETED - The request has been conpleted and the caller 

auakened if he had requested (with IOWRKE). 
Bit 7 DATAFRZN - Set by the menory managenent routines (NAN) uhen a 

MAKEPRESENT request is successfully conpleted and 

indicates the data segnent is frozen in nenory. 





6.23.00 6.23.00 
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2608 Line Printer Request Codes 19A 31 Line Printer I0 nent (HP- e 
Operation Function Paraneters ' ° ‘ 2 34 5 g ? s feed ed 14 15 ANERONIC 
sealeaeteesliealeo | eal ea ion jee] @2e lee] 2e/; ee i ee | eae jae 
URITE 1 Pt - Vertical Fornat Specification. z0| REQUEST DEPENDENT FLAGS | QF LAG 
1 - Use ist data char es fornat spec. | | erowoeceeeeee Were ncccsecnecccccesnconeccocnnen= 
253 - "4", print and suppress spacing. 1| SYSDB RELATIVE POINTER TO NEXT I0Q [QLINK 
ZSS - "=", print and triple space. | ELEMENT - POINTS TO FIRST WORD | 
Z60 - "0", print and double space. | OF ELEMENT 
261 - "1", print and top of forn. | | comwc ee wewe wenn wwen en wwn nnn nenocecnonnnneennn==| 
%200-2%277 - Print and space n-Z200 lines. 2| LOGICAL DEVICE NUMBER |QLDEV 
2300-2377 - Print with channel n-%277. | Jo-|e-l--|----2--- | encccowen en enneee | o-erceeenn- | 
All others - Print and single space. 3{PPIPE LPF ITOUTCN Ta ! WAITCODE Jantsc 
P2 - Space Mode Flags. 4| $| JQOSTN 
(15:1) - Prespace flag. | on [een nnn enn n nn nme w nen enen een eeeenocecocsen noes 
If set, print then fill buffer. §| OFFSET IN THE ORTA SEGHENT OR SYSTEN |QADOR 
If clear, fill buffer then print. | BUFFER TABLE TO THE TARGET DATA | 
(14:1) - No page stepover flag. | BUFFER 
If set, single and double space | eweencnewewecnnnnnowene  tatataahatetabeiatatetanataebetatenetatate | 
without stepover (66 lines/page). 6| | FUNCTION CODE | QFUNC 
If clear, single and double space | pane nen en newman nmnnnnn | ooo cmon nee nen nenea- 00 | 
with stepover (60 lines/page). 7| yousct 
FILE OFEN 2 Page eject if not at top of forn. 10} PARAMETER 1 apart 
FILE CLOSE 863 Page eject if not at top of forn. 11 PARAMETER 2 , {QPAR2 
DEVICE CLOSE 4 Page eject if not at top of forn. 12| | QUALIFIER | STATUS |QSTAT 
READ STATUS 217 Read 1/0 status. 13] PCB NUNGER |QPCBN 
Count - buffer nust be at least 2 bytes. | ewww mann nn nnn wen nnn - ~~ no noon en ene nnn enenereen=- | 
VFC SET Z100 Load VFC RAR. 
Count - Forn length in uords QFLAG - Request dependent flags. 
(0 loads RAR fren internal ROM). Bit © ABORT - Abort thas request and return a> error indication 
Pi - 6 for 6 LPI or 8 for 8 UPI to the caller. 
any other value defaults to 6 LPI. Bit 1 SPECIAL - Apply special handling to this request (unused). 
Bit 2 OIRG - This 18 a request fron the aiagnes*:c subsysten 
TRE SET 2101 Sets iogical colunn definition. (urused). 
P1 - 0 to 15, any other value defaults to 15. Bit 3 SYSGUFF - Target 18 an indey reiai.ve to che SBUF Table of 


the data buffer. 

Bit 4 IOQWAKE - Wake caller on conpletice cf request. 

Bit 5 BLOCKED Blocken 1/0. The co.ier .s waated in ATTACKIO 
untal the request is conpieted; anclies LimAKE. 

Bit 6 COMPLETED - The request has beer completed end the cal.er 

auakened if he had requested (Lith QURKE). 

Bit 7 DATRFRZN - Set by the nenory managenert routines (MAN) when a 
MAKEPRESENT request is successfully corpleted and 
indicates the data segnent .s frozen in nencry. 

Bit 8 MANERRORD - An error has occurred while NAN was trying to 
make the target data segnent present and ‘reeze 
it in nenory. 


6.23.00 6.23.00 
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1/0 


Bit § PREQ - (Unused). 

Bit 10 SFAIL - Delayed failure of SIO instruction; if a cali to 
STARTIO resulted in the request being added to 
the channel queve, this bit indicates that the SI0 
instruction failed when the request was selected 
for execution. 

Bit 11 PFAIL - The request was aborted because of a systen pouer 
failure. 


QNISC - Driver request dependent flags and counters for 2631. 
PRE'TO’POST - Pre to post spacing change flag. 
PEJECT - Last operation was a page eject. 
TOUTCNTR - Channel tine-cut retry counter. 
POUERFAIL - Power fail flag indicates pouer fail occurred. 
WAITCODE - Indicates type of wait: 
0 - New request. 
1 - Conpletion wait. 
2 - Not ready uait. 


QOSTN - If QFLAG.(3:1) is clear then this is the DST nunber of the 
target data segnent; if S is set, QAODR is 08 relative. 


QUBCT - On initiation, specifies the word count (> 0) or byte count 
(< 0); at conpletion of the request this location contains 
the actual transmission count in the sane units (bytes or 
words) a8 in the request. 


6.23.00 
13- 107 


2619 Line Printer Request Codes 


Qeeration Function Paraneters 

URITE 1 P1 - Vertical Fornat Specification. 

1 - Use ist data char es fornat 
specificatica. 


253 - "4", print and suppress spacing. 
x5§ - “-", print and triple space. 
Z60 - “O", print and double space. 

261 - “1", print and top of forn. 


%200-2277, Print and space n-Z200 lines. 
2300-2312, Print with channel N-Z277. 


2320 - Fill Line Printer Buffer Only. 
All others, print and single space. 


P2 - Space Mode Flags. 

(15:1) - Prespace flag. 
If set, print then fill buffer. 
If clear, fill buffer then print. 

(14:1) - No page stepover flag. 
If set, single and double space 
without stepover (66 lines/page). 
If clear, single and double space 
with stepover (60 lines/page). 


FILE OPEN 2 
FILE CLOSE 863 
DEVICE CLOSE 4 
RERD STATUS 217 


Page eject if not at tcp of forn. 
Page eject if not at top of forn. 
Page eject if not at top of forn. 


Read /0 status. 
Count - buffer size. 


SIOENTIFY 2110 


SSELF TEST: 
INITTGTE =. X91 


Return IO value in Bank & Buffaddr. 


Subtest nunber to execute in Bank and Buffadde 

(subtest nunber ranges fron 0 to 7). 

STasuS Z112 Subtest result returned in Sank & Buffaddr. 

SLOOPBFCK TEST: 
WPT ORTA Z113 
READ DATA 82114 


Data to LP in Bank & Buffadde (PING). 
Data fron LP read into Bank & Buffadde (PONG). 
Count - Buffer Size (256 bytes nax). 


G. 23.00 
13- 109 , 


012345 67 8 91011 12 13 14 15 


| 

| 

| 23/PP|PE(PF|TO| BF | 
| [m-}--f--]--1--1 
| 

| 

| 

| 


QNISC - Device dependent Fiags: 


IAT Y CODE [anise 





TOUTCNTR - (TO) Channel tinecut flag. 
BUF’FILL - (OF) Buffer fill operation in progress. 


QSTAT - PCB nunber and request conpleticn status: 

PCEN - The process control block (PC8) nunber of the process 
which made this request; if zero, the request is not 
associated with any process and the I0Q elenent 18 to 
be returned by the systen when the request has conpleted. 

STATUS - General status indicating the final state of the request. 
The following codes are used: 

0 - Not started or awaiting conpletion. 
1 - Successful conpletion. 
2 - End-of-file detected. 
3 - Unusual, but recoverable, condition detected. 
4 - Irrecoverable error has occurred. 
QUALIFIER - A code whach further defines or qualifies the general 
status (see the section Driver Return Status Codes 
earlier in this chapter). 


1 Line Printer R 


Qceration Function 
WRITE 1 

FILE PEN 2 

FILE CLOSE = 3 
CEVICE CLOSE 4 

READ STATUS X17 
VFC SET 2100 


G. 23.00 
13+ 108 





Pi - Vertical Fornat Specification. 
1 - Use ist data char as fornat 
specification. 


253 - “*", print and suppress spscing. 
255 - "=", print and triple space. 
260 - “O", print and double space. 

261 - "1", print and top of forn. 


%200-Z277, print and space N-%200 lines. 
%300-Z25N07, print with channel N-Z277. 


320 - Fill Line Printer Buffer Only. 
All others, print and single space. 


P2 - Space Mode Flags. 

(15:1) - Prespace flag. 
If set, prant then fill buffer. 
If clear, fill buffer then prant. 

(14:1) - No page stepover flag. 
If set, single and double space 
without stepover (66 lines/page). 
If clear, single and double space 
with stepover (60 lines/page). 


Page eject if not at tep of forn. 
Page eject if not at top of forn. 
Page eject if not at top of forn. 


Read 1/0 status. 
Count - 1 byte mininun required. 


LOADS VFC RAR 
P1 - 1-1 LPT (lines per inch) 
2-2 UI ; 
3-3 LI 
4-4 UI 
§-5 VI 
6-6 LPI 
8-8 LPI 
12 - 12 LPI 
Ray other value defaults to 6 LPT. 
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1/90 
1/0 Queue Elenent For HP-78 Card Reader 
01234 5 6 ’ , ge 12 13 14 1§ ANENONIC 

|-- eelealeasi@a@se)i eei enti ee eaelealeaeliee i ae i ee | oe ew 
. REQUEST DEPENDENT FLAGS (SEE BELOW) {QF LAG 
1]  SYSDB RELATIVE POINTER TO NEXT I0Q ELEMENT. {QLINK 

| POINTS TO FIRST WORD OF ELEMENT. | 

| nen nww cance cnenn enna nn ew ener new enn ne eenenennne= 
‘ LOGICAL DEVICE NUMBER JQLDEV 
3| federal BUFFER FLAG. Nitas 

Oe ee oe 
4| S| IF QFLUAG.(3:1) IS CLEAR THEN THIS IS THE {QDSTN 

| | DST NUMBER OF THE TARGET OATA SEGHENT. IF | 

| S$ IS SET, QADOR IS 08 RELATIVE. | 

A en ae 
S| OFFSET IN THE DATA SEGHENT OR SYSTEM BUFFER |QADDR 

| TABLE TO THE TARGET “ie BUFFER. | 

|--nennecenaenaceocnnnns | onenceneneeerroveceeen= | 
6| | FUNCTION CODE FOR {QFUNC 

| | THIS REQUEST. (SEE | 

| ! NEXT SECTION. ) ! 
7| GN INITIATION, SPECIFIES THE WORD COUNT (>0)/QUBCT 

| OR BYTE COUNT (<0). AT COMPLETION OF THE | 

} REQUEST THIS LOCATION CONTAINS THE ACTUAL | 

| TRANSHISSION COUNT IN THE SAME UNITS (BYTES | 

| OR WORDS) AS IN THE REQUEST. 
10| PARAMETER 1. CONTAINS THE EOF SPECIFICATION |QPARI 
41] PARAMETER 2. CONTAINS THE DATA MODE | QPRR2 

| SPECIFICATION IN BITS (11:2). (SEE BELOW CARO | 

| READER REQUEST CODES FOR DETAIL INFORMATION) | 
12| | QUALIFIER | STATUS |QSTAT 
13) PCB NUNBER oa 

6.23.00 
13- 111 
1/0 
isc R 0 ue nen 


012 3 4 5 6 7 8 § 10 11 12 13 14 15 MNENONIC 


O| REQUEST DEPENDENT FLAGS (SEE BELOW) [QF LAS 

| REQUEST URGENCY CLASS SSC ss 
o\” toeital bevice MER Cd 
3)cnna? 1S {OP [IML SRIRTRANILE|SP| | WAITCODE Lanse 
als) 0st Gr process 0180170) ——~——~sdnscm 

| | OST (IF SEGMENT TRANSFER) (S=STACK] | 
s|, OFFSET IN THE DATA SEG (IF PROCESS DISC 1/0) I¢nDOR 

|  AOORESS IN BANK (IF OS onENT TRANSFER) | 


UNIT @ | FUNCTION CODE FOR | QFUNC 
| THIS REQUEST. l 


| 

| 

7] ON INITIATION, SPECIFIES THE WORD COUNT (>0)|QNBCT 
| OR BYTE COUNT (<0). AT COMPLETION OF THE 

) REQUEST THIS LOCATION CONTAINS THE ACTUAL 
TRANSMISSION COUNT IN THE SANE UNITS (BYTES 
| 
| 
| 
| 
| 
| 


OR WORDS) AS IN THE REQUEST. ! 
| 
| 


P1 - PARAMETER 1 (USUALLY HIGH ORDER OF 


10 QPARI 
CURRENT LOGICAL DISC ADDRESS (CLDA1)) ! 

11] P2 - PARAMETER 2 (USUALLY LOW ORDER OF | QPAR2 
CURRENT LOGICAL DISC ADDRESS (CLOAZ)) ] 

12] | QUALIFIER | STATUS {QSTAT 

13} PCB |QPCB 


| 
15] SYSBASE RELATIVE INDX OF WEXT REQ IN QUEUE |GNEXTREOP 


16) IQSEGIDENT 
, = SEGIDENTIFIER (IF SEG TRANSFER) -| 
1 


| 299 S0 O8SO O46 6 0824 OSS 8 OSSESEEHS9S 2984S SEHOETOESCO | 


2O|DISPLACEMENT OF READ OR WRITE FROM SEG BASE(MN) |QSEGOISP 


S088 6988 OO OO08 OSS O98 FSEE C2 GOO OES8ESG8E 2SHSS8 088888 | 


6.23.00 
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QFLAG - Reques 
Bit O ABORT 
Bit 1 SPECT 
Bit 2 DIAG 
Bit 3 SYSBU 


Bit 4 IOWRK 
Bit S BLOCK 


Bit 6 CCMPLETED 


Bit 7 DATAF 


Bit 8 MANES 


Bit 9 PREQ 
Bit 10 SFAIL 


t dependent flags. 


- fbort thas request and return an error indication 
to the caller. 

AL - Apply special handling to this request. (Not used) 

- This is a request fron the diagnostic subsysten. 

FF Target as an index relative to the S8UF Table of 
the dats buffer. 

E Wake caller on conpletion of request. 

£0 - Blocked 1/0. The caller is waited in ATTACHIO 

untal the request 1s conpleted. Inplies IOWAKE. 

The request has been completed and the caller 

auakened if he had requested (with IOWAKE). 

RZN - Set by the nenory management routines (MAN) when a 
MAKEPRESENT request 1s successfully conpleted and 
indicates the data segnent 1s frozen in nenory. 

RORD - An error has occurred while MAN uas trying to 

nake the target data segnent present and freeze 

it in nenory. 

(Not used). 

Delayed failure of SIO instruction. If a call to 

STARTIO resulted in the request being added to 

the channel queue, this bit indicates that the S10 

instruction failed when the request was selected 

for execution. 


Bit 11 PFAIL - The request was aborted because of a systen power 
failure. 
QnIse - Auxiliary buffer flag used to indicated a read into the 


QSTAT - 
PCBN - 


STATUS = = 


driver's buffer and not the user’s buffer. 
PCB nunber and request completion status. 


The Process Control Block (PCB) nunber of the process 
uhich made this request. If zero, the request is not 
associated with any process and the I00 elenent is to 

be returned by the systen uhen the request has conpleted. 
General status indicating the final state of the request. 
The following codes are used: 


0 - Not started or awaiting conpletion. 


1 - Successful conpletion. 
2 - End-of-file detected. 
3 - Unusual, but recoverable, condition detected. 


4 - Irrecoverable error has occurred. 


QUALIFIER - 


1/0 


QFLAG - Reques 


Bit 0 ABORT 
Bit 1 fNREQ 
Bit 2 OIAG 
Bit 3 SBUF 


Bit 4 IQWAK 
Bit 5 BLOCK 


A code which further defines or qualifies the general 
status. (See the section Driver Return Status Codes 
earlier in this chapter. ) 


6.23.00 
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t dependent flags 


- Request has been aborted externally. 
- Request is for a segnent transfer. 
- This is a request fron the diagnostic subsysten. 
- Target is an index relative to the SBUF Table of 
the data buffer. 
E - Wake caller on conpletion of request. 
ED - Blocked 1/0. The caller is wasted in ATTACHIO 
until the request is conpleted. Inplies IOWAKE. 


Bit 6 COMPLETED - The request has been conpleted and the caller 


Bit 7 OATAF 
Bit 8 MANER 


Bit 9 PREQU 


Bit 10 SFAIL 


Bit 11 PFRIL 


Bit 12 CURRE 
Bit 13 DISAB 
Bit 14 DISAT 
Bit 15 ASGOO 


QLDEV.QLDEVN - 


auakened if he had requested (wath IQURKE). 
RIN - Data segnent has been present and is frozen. 
RORD - An error has occurred while MAN was trying to 
nake the target data segnent present and freeze 
it in nenory. 

EUED - Request is queued into disc’s request queue. 

- Delayed failure of SIO instruction. If a call 
to STARTIO resulted in the request being added 
to the channel queve, this bit indicates that 
the SIO instruction failed when the request was 
selected for execution. 

- The request was aborted because of a systen 
power faalure. 

Q - Request is device’s current request. 

LED - Request is disabled. 

MPT - Attenpt to disable this request. 

NE - fA nessage request reply has conpleted. 


Logical Device Nunber. 


QNISC - Driver request dependent flags and counters. 


CHAN'ERR'FLG - Channel error retry flag. 
RSTAT’FAIL’FLG - Request status failed flag. 
OPER’REQ’FLG - Operator requested release flag. 
IM’FRULT'FLG - Internal naintenance fault flag. 
STAT’RIRY’FLG - Status error single retry flag. 


RTRANS’ FLG 
LORD'FLG 


- Retransnit required flag. 
- Media load flag. 


SYS'PFAIL’FLG - System pouerfaal flag. 


WAIT CODE 


- Indicates type of wait: 


0 - New request. 

1 - Completion wait. 

2 - Not ready wait. 

3 - Release/release deny uait. 
4 - 30Q defer wait. 

§ - BSCT read wait. 

6 - OSCT urate wart. 

7 - Synchronization wait. 
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QDSTN - If systen buffer is clear then this is the OST 
nunber of the target data eegnent. If bit 0 is 
set then buffer address is 2 08 offset value 
instead of seqnent relative offset (inplenented 
for NOWARIT 10 and NOBUFF). 


QROOR - Offset in data segnent or systen buffer table to 
target data buffer. 


GFUNC - Function code and qualifiers as specified by 
draver. 


QSTAT - PCB nunber and request conpleticn status. 

PCBN - The Process Control Block (PCB) nunber of the process 
uhich nade this request. If zero, the request is not 
associated with any process and the I0Q elenent is to 
be returned by the systen uhen the request has conpleted. 

STATUS - General status indicating the final state of the request. 
© - Not started or awaiting conpleticn. 

1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
4 - Irrecoverable error has occurred. 


QUALIFIER - A code which further defines or qualifies the general 
status. (See the section Oraver Return Status Codes. ) 
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INP 100 Field Definitions 

OF LAG - Flags end Control Infornation. 

- ABORT - If set, then request has been aborted. 
-DIAG - Diagnostic Flag. Not used. 

-SYSBUFR - Systen Buffer Fleg. Mot used. 

-IOWRKE - Wake caller on completion of request. 


.BLOCKED - Blocked I/0. Caller is waited in ATTACHTO until the request 
is conpleted. Inplies uake. 


COMPLETED - Request has been conpleted and caller auoken (if specified) 
and request is no longer known to the Driver. 


-DATRFRIN - If set, the target data seqnent is frozen in nenory. 
Set by MAN uhen a delayed nake present request is 
successfully conpleted. 


-MRMERRD «=- A AN error has occurred in trying to nake present and 
freeze the target data segnent. 


-REROURITE - If set, then this request allows data to be received after 
data is sent. The read target buffer offset is in QPRRI and 
the read target buffer length is in GPRRZ. . 


-HELD - If set, processing of this request has been suspended 
because INP did not have buffer space available. 


.MORDCOUNT - If set, QUBCT specified uords, else GUBCT specified 
bytes. 


-PREEMPT - Preenpt Code. Mot veed. 

TIME - If set, a softuare tineout is started when the request 
initiation message is sent to INP and the Request 
Conpleticn nessage nust be received before the tineout 
expires. 

-ABCRTER - If set, this is a request to abort another request. 

QLINK  SYSO8 relative pointer to the next new 100 elenent. 

OLDEV - Holds Logical Device Nunber and Current Queue Index. 

.OLDEVN = =-_ Logical Device Nunber of Controlier. 


QnIsc - fliscellaneous paraneter. Use varies with Function Code. 
See INP FUNCTIONS for specific meaning. 


QDSTN - DST Nunber and Request State. 
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| 601234 5 6 7 8 $10 1% 12 13 14 15 


| |--| | 
TOQO{AB] 10 [SBIWAIBLIC JFRIERIRWIM |WC|PRMPT|TIIAR|QFLAG 





1001| 1060 INDEX TO NEXT NEW REQUEST | QLINK 
ciel Le IOLDEV 
Gol Mea ontse 
wie eos 
rous| ‘TaRset baTA BUFFER ADDRESS SSS aon 
soos} UEVE | SERVICE | FUNCTION CODE JOFUNC 
now) Mano  suact 
| onio} baRRRETER W/E DATA COT fe 
+ i ae fre 
| sootel ennon COE RLU! LCSTATUS JostaT 
| rg] ee eR eles oy por 
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-DOFLAG «= >—«STF eet, QRDOR is the offset fron 0B to the target 
buffer, otherwise QROOR is the offset fron the DST base. 


GAOOR - Offset to target data area fron data segnent base or D8. 
GFUNC - Error Code and Function. 


- QUEUE - DIT relative index to head of queue holding this requests. 
0 - Input Queue. 
9 - Ready Queve. 
1 =. Retive Queue. 
13 - Waited Queue. 


SERVICE - Service code. This field controls the operations to be done 
for this request end its disposition on conpletion. 


© - Send message only, no data. 

1 - Send nessage and data. 

2 - Rove data fron trace write to trace read buffer. 
3 - Rove Logical Driver Status Block to target buffer. 
4 - This is a request to abort another request. 

§ - Message has been sent to INP. 

6 - Receave data fron INP. 

7 - Issue a pouer on reset. 

8 - Complete request when JOSTATE is inactive. 

§ - Soft Abort pending cn this request. 
10 = Send data requested with Soft Abort pending. 
11 - No service currently required for this request. 


-FUNCTION - Function Code as specified by driver. 
QuecT 


Word or byte count. fay also be used to return information 
certain functions. On initiation, it specifies a word count 
positive or a byte count if negative. It is converted to a 
count during preprocessing of the request with the sense kept 
in the flag WORDCOUNT. At completion, the ectual trasnission 
count is returned in thie uord with the sane sense as the 
original specification. 


QPRRI 


Paraneter one as defined by the driver. Uhen 

a request has been conpleted and data is to be received, the 
uord contains the byte count of the data to be received. 
QPAR2 - Paraneter tuo as defined by the driver. 

QSTAT - Caller PCB Nunber and request conpleticn status. 


-ERRORCOOE - The Irrecoverable Error Code as defined in CS ERS. 





LS - Line State. If set, the line is connected. This field is 
valid only for read and write conpietions. 
UR - If set, this uas a write request conpietion. 
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.CSTATUS - Encoded Completion Status. 
1 - Successful Conpletion. 
2 ~- End of Transmission. 


CS 80 Integrated Cartridge Tape Request 





2: Hrestverad fecoverabe Error Completion epee ee ee 
5 - Catastrophic Controller Error. O| REQUEST DEPENDENT FLAGS (SEE BELOW) | QF LAG 
QPCBN - PCB Nunber of the originator of this request. If zero, this 1} REQUEST URGENCY CLASS Pin v eine aren | QURGCLASS 
ee eg nee ge ete [ Jn ney 
slcnanelaslaplanl retey {Ur(SPi | WAETCODE ” [ORISC 
| a| S| ost Gi pwacessonst 170) ——~—~—*abst 
| | | OST (IF SEGNENT TRANSFER) [S=STACK} | 
| sf TGS Te nin Sg GF GES SE 17) fo 
| ADDRESS IN BANK (IF SEGHENT TRANSFER) | 
ae Witt | FUNCTION CODE FOR [QFUNC 
| | THIS REQUEST. ] 
wt Gn TRETTATION, SPECIETES Tne WORD COUNT” (00) lQMECT 


| 
| OR BYTE COUNT (<0). AT COMPLETION OF THE | 
| REQUEST THIS LOCATION CONTAINS THE ACTUAL | 
| TRANSAISSION COUNT IN THE SANE UNITS (BYTES | 
} OR WORDS) AS IN THE REQUEST. | 


| 
10} 1 - PARAMETER 1 (USUALLY HIGH ORDER OF |QPAR1 
| CURRENT LOGICAL DISC ADDRESS [CLOA1)) | 


| peewnn wwe e nn nnn nw nn nn enn n nna vennnenenerennesee= 

11| P2 - PRRAMETER 2 (USUALLY LOW ORDER OF | QPAR2 
CURRENT LOGICAL DISC ADDRESS [CLORZ)) | 

12] PCBN | QUALIFIER | STATUS |QSTAT 





i SEGIDENTIFIER (IF SEGHENT TRANSFER jaseereen 
; 16| ee OF RERD OR WRT FROM SEG BASE (AM) (GSEGDISP 
17|S | | 
|u| | 
[A | | 
\P | | 
| |-- | -rownnnecernnnnnnenenncenenennnrenenennnces| 
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QFLAG - Request dependent flags. QDSTN - If systen buffer is clear then this is the dst 


nunber of the target data segnent. If bit 0 is 


Bit O ABORT - Request has been aborted externally. set then buffer address is a 0B offset value 
Bit 1 MAREQ - Request is for a segnent transfer. instead of segnent relative offset (inplenented 
Bit 2 DIAG - This is a request fron the diagnostic subsysten. for NOWAIT 1/0 and NOBUFF). 

Bit 3 SBUF - Target is an index relative to the SBUF Table of 


the data buffer. 
Bit 4 IQUAKE - Uske caller on completion of request. 
Bit 5 BLOCKED - Blocked I/0. The caller is waited in ATTACHIO 
until the request is conpleted. Inplies IOWAKE. OFUNC - Function code and qualifiers as specified by 
Bit & COMPLETED - The request has been conpleted and the caller driver. 
auakened if he had requested (with IQURKE). 
Bit 7? DATRFRZN - Data segrent has been present and 18 frozen. 
Bit 8 MANERRORD - An error has occurred while MAM was trying to 
nake the target data segnent present and freeze PCBN - The Process Control Block (PCB) nunber of the process 
it in nenory. which nade this request. If zero, the request is not 
Bit 9 PREQUEUED - Request is queued into disc's request queue aesociated uith any process and the I0Q elenent is to 
Bit 10 SFAIL - Delayed failure of SIO instruction. If a call be returned by the systen uhen the request has conpleted. 
to STRRTIO resulted in the request being added 
to the channel queue, this bit indicates that 
the SIO instruction failed uhen the request was 
selected for execution. 


QRDDR - Offset in data segnent or systen buffer table to 
target data buffer. 


QSTAT - PCB nunber and request completion status. 


STATUS - General status indicating the final state cf the request. 
0 - Not started or auaiting conpleticn. 





Bit 11 PFAIL - The request was aborted because of a systen 
pouer failure. 

Bit 12 CURREQ - Request is device’s current request. 

Bit 13 DISABLED - Request is disabled. 

Bit 14 DISATHPT - Attenpt to disable this request. 

Bit 15 ASGOONE - A message request reply has conpleted. 


QLDEV.QLDEVN - Logical Device Nunber. 
OQNISC - Driver request dependent flags and counters. 


CHAN’ERR’FLG - Channel error retry flag. 
RSTAT'FAIL'FLG - Request status failed flag. 
CPER’REQ’FLG - Operator requested release flag. 
IN’FRULT'FLG = - - Internal maintenance fault flag. 
RETRY’COUNT - Retry count area. 

LORD’ FLG - Media load flag. 

SYS’PFAIL’FLG - Systen pouerfail flag. 


UATTCOOE - Indicates type of uait: 


0 - New reques*. 

4 - Conpletaon uait. 

2 - Not ready wait. 

3 - Release/retesse Jeny wait. 
4 - 100 defer uait. 

S - OSCT read wart. 

6 - OSCT urite uait. 

7 = Synchronization uait. 
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1 - Successful completion. 

2 - End-of-file detected. 

3 - Unusual, but recoverable, condition detected. 
4 - Irrecoverable error has occurred. 


QUALIFIER - A code which further defines or qualifies the general 


status. (See the section Driver Return Status Codes 
earlier in this chapter. ) 
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| 
| ENTRY SIZE |TSIZE 
| PRIMARY # 


| 
|ennnennnnanannncenseracenneerennes srecarncene --| 
|  IMPEDED PROCESS PCE 


| 
o-| TAIL INDEX LAKE 
| MAXIMUM OF IN USE | TUSE 


| CURRENT IN USE Se 


ENTRY 1 
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ENTRY 4 
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| 
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| 
| 
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| 
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| 
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Tab nen ation nt. 


equest types 2 and 3 return an indication to the caller if the request 
ould not be satisfied. The following table specifies the types of calls 


for elenent allocation and the action if an elenent is not activated. 


BUFFER USER CALL TYPE FINAL ACTION 
SBUF’s . 

File systen Inpede -- 

Ptape Inpede ooo 

Bad track Prinary | Forget request 
100°s 

ATTACHIO (can be inpeded) Prinary Return 100K-0 
ATTACHIO (can be anpeded) Inpede woo 

SIOOM (nenory nanagenent) Secondary Sudden death 
IONESSAGE Secondary 1/0 error 
HEADER DEFINITION: 

Prinary @ - Wunber of elenents in the prinary area. 

Total # - Total nunber of elenents in the table. 

Size. - Size in words of each elenent. 


Inpeded PCB 0s ~ «If not zero then contains the PCB nunber of the 
firet process waiting for an elenent in this table. 


Head index - Index of first free elenent. 

Tail index - Index of last free elenent. 

In use - Current nunber not in free list. 

Overf lous - Nunber of requests nade for an elenent. 


Total requests - Total number of elenents requested. 
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Tab lenent Allocation (SBUF 


The allocation of the elenents in the 100 terminal buffer (TBUF) and 
systen buffer (SBUF) tables is of concern to the 1/0 systen. 


Free List Of Table Elenents 


These tables are in the torn of a free-linked list of the free elenents. 
For the SBUF's the -1 word of entry is the link to the next elenent. 
For the TBUF’s, uord zero is the lank and word 1 18 the lank for the 
I0Q elenents. 


Each uord has an 11-word header beginning at the base of the table . The 
first six words of the header are for nanaging the table and the second 
five are for monitoring table activity. 


The entries follow the header at word eleven. 


Elenent Allocation 


Elenents are obtained fron the beginning of the free list, pointed to 
by the head and returned to the end of the free list pointed by the tail. 


Uhen the free list is enpty, the head index is zero and the tail index 
is set to point at the head index. 


The tables are divided into tuo areas: a primary and a secondary area. 
Most requests are obtained fron the prinary area. The secondary area 18 
used only for critical requirenents when the primary area is exhausted. 
These areas are logical areas deternined by parameters in the header. 


The utility of the core resident tables is seriously reduced if their 
use is not restricted to dynamic situations. 


One of three responses nust be specified to the routines uhich allocate 
elenente from the I/0 eysten tables: 


1. Impede caller if prinary is enpty. 
2. Get fron prinary area only. 


3. Get fron secondary area if prinary area is enpty. 
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Seige re OCT megane er 
lore| ea aaa 
sea ea | 
|or-63] = _CWRESERVED | 
lore) SCRESERED | 


| am-61| CANDIDATE PIN THAT SYSTER 1S SERVICING |TCS*CRMDPENCELL 
| ar-6o|” ¢ FILTER LAST TRANSACTION TINE MULTIPLIER |ICS*CUTLASTTRANUTCELL 
lor-s7)SS*~*S*«é ASE ~_ FICS*PRUSETERECELL 
{ acer TINE : 
| QI-5S/IN/10|  RERSURERENT INTERFACE FLAGUORD | |ICS*LISTSTATECELL 
I AECKGROUND FILTER USED FOR QUANTUN UPDATE |TCSCUREFTLTERCELL! 
| Gr-53) BATCH FILTER USED FOR QUANTUN UPDATE |TCE*CURDFILTERCELL® 
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1/0 
nterrupt Cont tack (ICS) Fornat (Cont. 
01234 5 of ie ‘ ae tea arp Sy 
| wo foe [on foe[on[em fon lonfentooloctenlerdsslenton 
| QI-50| TINE IN CPU BEFORE PRIORITY CROP | ICS*CURCFILTERCELL 


| Q1-47| MINIMUM TIME IN CPU BEFORE PRIORITY OROP J ICS’ MAXCFILTERCELL* 


| 
| QI-46| MAXIMUM TIME IN CPU BEFORE PRIORITY DROP JICS’MINCFILTERCELL* 


| QI-4S} MAXINUN PRIORITY (LOWEST VALUE) | ICS’ ESCHEOBASECE LL* 
| WHEN ON E QUEUE | 
| cow assowe een ces aee oeewee cow eeseseownocoooeoooce 

| Q1-44| MAXINUN PRIORITY (LOVEST VALUE) |ISC’ DSCHEDBASECELL* 
| UREN ON O QUEUE | 

| Q1-43] MAXINUM PRIORITY (LOWEST VALUE) | ICS* CSCHEDBASECELL* 
| WHEN ON C QUEUE | 

eccwecewceccwcescsnweeecncns cre ceeecoccercccor=s | 

| Q1-42| MININUN PRIORITY (HIGHEST VALUE) |ICS* WORSTEPRICELL* 
| WHEN ON E QUEUE 

| Qf-41] MINIMUN PRIORITY (HIGHEST VALUE) IICS* WORSTOPRICELL* 
| WHEN ON O QUEUE 
| anes cece cece awe ecn 200000 es eros cecesenesasoeens 

| Q1-40] MINIAUN PRIORITY (HIGHEST VALUE) [ISC’ WORSTCPRICELL* 


rich ON C QUEUE 


| 
| QI-36| £ QUEUE PRIORITY OSCILLATION ENABLED | 


| 
| QI-35{ 0 QUEUE PRIORITY OSCILLATION ENABLED | 


|----onnnnnnccnnnnsneennenennernnnenenneenennn= 
| Q1-34] C QUEUE PRICRITY OSCILLATION ENRBLED | 


wccccceecneneenennnwnsnrseseenecnneneneeenennns 

| QI-33] BOUNDS CHECKING - XDS’ BRNK ADDRESS eee 
| ICS’ XOSEGBASECELL( 64] 

QI-31| BOUNDS CHECKING - LAST VALID XDS' SEGHENT # |ISC’DSEGLINCELL(64) 


{BNDS ioe RSE 
Q1-27| 
| ar | 
| Qz-25| PAUSE | 
|- TIN -| 
| ae (NPE III ONLY) 
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QI-45 MEASUREMENT INTERFACE word: 
Bit 0 2 In-Notion-In Flag (IM). 
1 * OISC 1/0 is bit (10). 
2-15 = Neasurenent Interface Word. 


QI-31 SIMULATIONS word: 
Bit 121 if to enable stack underflow simulations call 
by STRCKUNDERFLOW in ININ. 


QI-24 Privilege Mode Bounds Checking. 
Bit = Rbsolute Node - DB and 08 bank not matched (AM). 


8-9 = Mode field (NOOE). 
2 0 if stack node ~ 08 = extended CPU register XRR120 
and 08 bank = extended CPU register KRB1200. 
# 1 if low core node - OB<sextended CPU register 
XRAI22 and 0B bank <eextended CPU register XRB122. 
2 2 if xdseg node - 08 2 extended CPU register XRAIZ1 
and 0B bank ® extended CPU register XRB121. 


14-15 = Bounds check flag (BNDS). 


= © if 08, Q, and S bounds enabled. 

z 1 if OB bounds disabled, Q and S bounds disabled. 
= 2 DB bounds enabled, Q and S bounds disabled. 

2 308, Q, and S bounds enabled. 


QI- 2 Initial stack narker’s P word. 
Bit 0 = TRACE enabled flag bit (T). 
1 = logical:y/physically mapped code segnent (L). 
2-15 2 progran lccation value. 


QI- 0 Initial stack marker’s Q uord. 

Bit 0 = 1 if there is a cending DSP that cannot be 
processed innediately (e.9., DISPATCHER 
tias PDISRBLED or on the ICS). 

1-15 = 0 (indicating no previous stack narker). 


QIle 3 Interrupt Paraneter uord. 
<1 if Externel Frogran Label paraneter. 
© 1f a fara eter that 38 passed to internal interrupt 
hano.er. 
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Interrupt Control Stack (ICS) Format (Cont. ) 


| 0123 4 5 6 7 8 910 19 12 13 14 15 


| 
| QI1-23] PAUSE CODE (MPE III ONLY) 


| 
| Q1-22| OISABLE/ENABLE OISPATCHER TO RUN COUNTER escenrncre™ 


| 
| Qr-21| RESERVED | 


j Q1-20| CURRENT PROCESS STACK OST NUMBER (FROM PCB) eee 


| 
| QX-17| PSEUDO INTERRUPT PROCESSOR’S STATUS WORD |ICS’ PISTATUSCELL 


| QI-16] BASE ADDRESS OF PSEUDO INTERRUPT PROCESSOR {ICS'PIDELTAPCELL 


| il | 
| Q1-14| | 


O88 9088 OOS 8 OO BOOS 8 O82 OS SSE OS 6 OSHSSSTTOSASESFASCESTOCOD 


| 
| QI-13| ABSOLUTE JOB CUTOFF TABLE ENTRY ADDRESS {ICS’ IJCUTCELL 


| 
| QI-12| PCB RELATIVE ADDRESS FOR ENTRY OF CUR PROCESSIICS’CURPCBTCELL 


| 
| sas CURRENT PROCESS’ BASE ROORESS TO ITS STACK |ICS’STKBASECELL 
| QI-10| CURRENT PROCESS’ OB REL VALUE TO Z IN STACK |ICS’STKOBRELZCELL** 


QI- 7{ CURRENT PROCESS’ OB REL VALUE TO OL IN STACK |ICS’STKOBRELDLCELL** 


| 
QI- 6] CURRENT PROCESS’ 08 REL VALUE TO S IN STACK |ICS’STKDBRELSCELL** 


QI- S| CURRENT PROCESS’ BANK ADDRESS TO ITS STACK | ICS’ STKBANKCELL** 


| 
Qx- 4] CURRENT PROCESS’ BASE ADDRESS TO OB IN STACK |ICS’ ABSSTKOBCELL** 


| | 
QI- 3| INITIAL STACK MARKER’S X REGISTER VALWE | 


QI- 1| INITIAL STACK MARKER’S STATUS WORD | 


oe | meccncwccee meen cwnewwenewencecussccoonccacce | 
QI- olP | INITIAL STACK MARKERS Q VALUE (<0) =| 
QI+ 1{ INITIAL STACK MARKER’S OB BANK ADORESS | 
QI+ 2| INITIAL STACK MARKER’S OB BASE RODRESS | 


SF FO OG OS 282482484 22 6 £24E8SE4E4EF8 £24 2E8 828 FSS8SSSSETESOE 


QI+ 3] INTERRUPT PARAMETER 


& Tunable by the TUNE connand. 
ak = Known by the firnuare. 
(64) Series 64 only. 
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a Uith Initial Values 

ICS’RBSSTKOBCELL - Absolute address of the currently running 

process’ eteck. 
ICS’STKBANKCELL  - Bank address for process’ stack. 
ICS’STKOBRELSCELL - Stack 08 relative S. 
ICS’ STKDBRELDLCELL - Stack 08 relative OL. 
ICS’STKOBRELZCELL - Stack 08 relative 2. 
ICS*STKBASECELL  - Absolute stack address. 


ICS°CURPCBTCELL - PCB table relative pointer to word 0 of the 
running process’ Process Control Block. 


The above cells are to be initialized for the PROGENITOR. 
ICS*STKOSTCELL - DST nunber for running process’ stack. 


ICS’ JCUTCELL - The bank 0 absolute address of the JCUT 
(Job Cutoff) Table. 


ICS’PIDELTAPCELL - PB relative address for the procedure 
PSEUDOINT (handles pseudo/soft interrupts) 


ICS’PISTATUSCELL - Status value for PSEUDOINT (Z40000+CST#) 
ICS'’PDISCNICELL - PSDB counter, initially 0 
INITIAL sete the above as described. 
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C i nterrupt Linkage Tab T 


There is one ILT for each device controller configured cn the systen. A 
controller may support more than one unit, however the CS'80 dise driver uill 
only concern itself with the single unit controller. 


0123 4 5 6 7 8 9 10 11 12 13 14 15 ANENONIC 


0] CHANNEL |ICPVARO 
1} PROGRAN |ICPVA 
2| VARIABLE JICPVA2 
31 ARER (ICPVA) |ICPVA3 
| eccocwecsecnnwewcccessccows sence soosessccoscose 
4| DMA ABORT |ICPVR4 
ADDRESS eae 
‘| | 0 | |ISROL 
rAL ea CHANQUE | } CHAN | OEV [ICNTRL 


12| SINGLE INSTRUCTION THAT IS EXECUTED TO EXTRACT|IUNIT 
| THE DEVICE UNIT NUMBER FROM THE STATUS POINTED| 
} TO BY ISTAP. [SINCE ONLY UNIT O EXISTS ON THE | 
] CS’8O DISCS, ANDI O IS USED TO RETURN UNIT 0) | 

13] SYSOB RELATIVE OIT POINTER OF THE DEVICE \Icop 
| CURRENTLY USING THE CHANNEL TO PERFORA A i 
| OATA OPERATION. | 


|-erweneennnnennne= socne |-eeneenennnonnenee a---| 
14| SIOPSIZE | CQUEN peer 
1S {RU WPIIG! | HCUNIT [IFLAG 
16] SYSO8 RELATIVE DIT POINTER FOR UNIT 0 |IOITPO 


| ponenwewennencecennncccceenesesenn wencccnncoce i 
31} CS’80 DISCS | 
: CHANNEL : 
| PROGRAR | 
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Spooling 
HRPTER 14 SP N 
n vice Di u vi 


IDD/COD (Connon attributes referred to 3s X00) 
100: OST = 45 (255) 000: OST = 46 (256) 
SIR = 3 SIRs 4 


Overview of Table Structure 


| eoeweoeee Saaanoee PBS SONGS OSSSS OOSHSOO | 
. 


O| ENTRY O (8 WORDS) | 


SO 822 SSS SCO OSS6 98888288 POSES SSIS SBHS | 


2{ SUBENTRY AREA POINTER J---\ 


7 l 


| 222808 8S820820 888 2 O82 SESESE8 PE BOGOR 2OSOe | 


| 
| HERO ENTRIES (4 WORDS ERCH) 


eS A ED SD ES 
ay, Se ee SE ee ee Ce 


a 
a 
J 


SUBENTRIES (240 WORDS ERCH) 
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ICPVAO - Channel Progran Variable Area. 

The first word 18 used by the channel progran processor to store status 
infornatacn after I/O channel aborts. The next uord 1s used by the driver to 
indicate if status should be exananed for special conditions or errors. The 
other tuo words are not used. 

ICPVAS - OMA abort addrese. 


If a OMA abort occurs, the absolute address where the abort occurred 1$ 
stored in this area. 


ICNTRL - Contains controller infornation. 


LIA - If this bit 1s set, the controller is sharing a softuare channel 
rescurce in order to linit bandwidth. 


CHKANQUE - The software channel resource nunber. 
CHAN - Channel nunber (four nost significant bits of DRTN). 
DEV - Device nunber (three least significant bits of DRTN). 
IQUEUVE - The channel progran contains: 
SIOPSIZE - (nunber of words + 1)/2 in the channel progran area. 


COQUEN - or a multi-unit controller this field contains the softuare 
controller resource nunber. 


IFLAG  -Controller and Channel Progran state flags. 


RUNWAIT -Rn Idle Channel Progran should be started when there are no active 
requests to process. 


UAITPROG -An Idle Channel Progran has been started for this controller. This 
bit is reset by an interrupt. 


IGKOREHT -An HIOP instruction has been issued against this controller but the 
channel progran was not in a wart statement. Therefore, ignore 
the interrupt generated by the channel cede when this progran 
halts. 


HCUNIT -Highest configured unit nunber for this controller. 
ISTAT +20 bytes of status fron the idle channel progran. 
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345 6 7 8 9 10 11 12 13 14 15 
|= |o=fo=|-=]--1==[=-f-=]--1-=1--1--1--1--1--1-=1 
O| MAXINUN SIZE CURRENT SIZE 0 (SECTCRS) 


| 
marae | | 
1| HEAD ENTRY SIZE = 4 SUBENTRY SIZE = 240 [1 ( WORDS ) 


2| SUBENTRY RREA POINTER (SEGHENT RELATIVE) j2 














3]00] NEXT AVAIL DEVICE FILE I0 (OFID) 4 
4| | FENCE 14 
|--— enannnnnnna|aneeenenno=| 
§| 15 
| -eee wee cwwwwnwen econ ennnnceccocncocccccscosore=| 
6| 16 
| --oeene eemnwcecconcennce| 
7| (7 
|----—-- wnwwnnnnenennnnnnnnnnnnnn nen en=| 
00: 0 = This is the 100, 


1 = This is the 080. 


Fence: For spooled output devices (000), the systen-wide out- 
fence. For spooled input devices (I0D), the JOBFENCE. 
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Typical Mead Ent 4 Word 


012345 67 8 910 11 12 13 14 15 
[== Jon |--}==Jonforlo=lo=}==l-el--l-n len d--l-= 1+] 


DEVICE OUTFENCE 


| HERD POINTER 
| TAIL POINTER | 
| wee eccecen nn cwnee nner osenowesowcoscesoseensse 
1 LOGICAL DEVICE | 


There are tuo types of head entries; a class entry and a logical device 
entry. There 1s only one class entry; it 1s the first head entry in the ODD. 
The IDD does not have a class entry; position is filled with zeros. All 
spoolfiles opened by class (e.g., LP, SLOWLP, EPOC, PP) are linked to this 
entry. There 1s one logical device entry for each real (physical, as opposed 
to virtual) device on the systen. Output devices appear in the ODD, input 
devices in the IDD. AC/DC devices such as terminals appear in both 
directories. 


Each head entry is linked to 0 or nore subentries (a typical subentry is 
shoun in the next table). A null chain (0 subentries) consists of head 
pointer = 0 and tail pointer = segnent-relative address of the associated 
head pointer. If one or nore subentries exists, the pointers are 
segnent-relative addresses of the first uord of the first and last subentries 
of the chain. Ray internediate subentries are linked through the subentries. 
The taal subentry always contains a O-link. 


The Device QUTFENCE and LDEV# fields are neaningless for the class entry. 
For logical device entries (non-0 Logical Device field), a non Device 
OUTFENCE means that this CUTFENCE overrides the systen-uwide OUTFENCE in word 
4 of entry 0, but only for this device. 
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Note: Words 0-224 are used in all subentries. Words 225-237, 
although present in all subentries, are zero unless the 
subentry is for a spcoled file (spcolfile). 


Word 0 - STATE - State of subentry: 

0 = Active 

1 = Ready 

2 = Open 

3 3 Locked 

CL - 1 Nord 224 is a class index into the 
Device Class Table. 
© = Word 224 is the LDEV associated uith 

this subentry. 

Word 1- TYPE = Describes which envircnnent created the 
subentry: 

© ® Session’ (SPO0K) 
1 # Session 

2 = Job 

3 = Jeb’ (SPOOK) 

Word Z22 - 10 - 1 © Output DFIO 
0 = Input OFID 

Word %23 - FS - There are one or nore forns nessage 
requests in the spoolfile. 

dA - The spoolfile uas created via a :DATA record 
(input spooling cnly). 

HERD - The (segnent-relative address)/4 of the 

INDEX head entry with uhich this subentry is 
linked. Since head entries are four words 
long, this can be thought of as an index 
into the head entry portion of the X00 if 
you disallow values of 0 and 1. 

Word 224 - See description of Word 0. 

Uord 225 ~ VDEV  - LPOT index of virtual device LEV. 
Sinvlates the properties of a real LDEV to 
the process which FOPENs a new (previously 
non-existing) file (State field (xD0(0). 
(1:2)) = 2 (Open)). 

Vord 226 - VTINX - The volune table index of the logical 
device in class SPOOL where the file label 
(first extent) of the epoolfile lives. 

Word 232 - $Q - 1 8 Squeeze (purge) spoolfile extents as 

the final copy is printed. Obsolete 
starting with C.00.20. 
© = Purge only when final copy printed. 
RS - 1-8 Restart job uhen uarnstarting (input 
spooling only). 
FD - 1 There are non-standard forns on the 
device. 
$0 - Spaced Qut bit. File Systen could not 
acquire a new extent when creating spoolfile. 
RB - This is the SSTOLIST of an aborted job. 

Words 236-37 - Tine stanp when spoolfile was nade READY, or 
OD if not closed properly. Julian day is 
9 bate starting with Word 236, bit 8. 
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Typical Subent 240 Words 


012345 67 8 91011 12 13 14 15 


| a pales OUTPRI ea : 
| yi el JOB NUNBER \ 
; 2 \2 
| 3] USER NANE \3 
| 4 {4 
| 5I 15 
| poem enn nnn nn nnn nee ne nen nnewennnoreneosncerror= | 
| 6| \6 
| 7| ACCOUNT NAME |7 
|} 104 18 
} 11 \9 
| coon n wenn nnn nnn nnn nn ne nw ne cere nnn ennceroroecrn= | 
}  12| }10 
} 13] JOB NANE j11 
| 14] \12 
{ ie i 
| 16] 114 
| 17{ FILE WARE J15 
{| 2] 116 
; ail 147 
J} 22d ae FILE ID |18 
| 231FSIOR| | OD HEAD INDEX (SEE EXPLANATION) [19 
| 241 LOGICAL DEVICE, OR DEVICE CLASS TABLE INDEX {20 
| 25] VIRTUAL LOEV NUMBER OF OPEN SPOOLFILE j21 
| a VOLUME TABLE INDEX ! SECTOR RODRESS ice 
| a7 OF gh LABEL ! 
| 30] NUMBER OF EXTENTS | i. 
| LAST EXTENT SIZE (SECTORS) [25 
wolee| ow] eae |] oo] on [-- wo weer wee csecwweswsaseeases 
} 3218S) IRSIFO|SO{AS| | NUMBER OF COPIES 126 
{ 33] SEGNENT-RELATIVE LINK TO NEXT SUBENTRY, 127 


| THIS DEVICE OR CLASS. O = LAST SUBENTRY. | 


| 34] NUMBER OF RECORDS IN SPOOLFILE (OOUBLEWORD) [28 


{ 35 |29 
eT rr ae I SULTAN DAY OF YERR/2 (30 
ail me mone 
ieee por ae 
14-4 
Spooling 


SPOOK Tape Fornat 


The overall fornat of output tapes produced by the SPOOK “OUTPUT” connand is 
shoun below. The various conponents of the tape are then described in 
detail. The fornat described here is subject to change as MPE evolves. 

Also, there nay be errors in SPOOK uhich uould cause the actual tape fornat 
to differ fron the one described here in sone cases. All nuneric information 
is in integer fornat unless otherwise specified. 


| €0F j 
| owner emnw en nnn none nn nn enone nennnnnnnee | 
| €0F . 
| LRBEL RECORD 
| €0F 


OS C8 © OO C6 8 O28 2828S 82S SS 2E80 SS CONEEHHA®“SOS 





| EOF | 
ane 
| ear See 
foun | 
ge 


Mechanisns for end-of-tape and tape euitching are the sane as for 
STORE/RESTORE tapes. 
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Label Record 
ese wccneconccnn coe nesses eneeesesoosoossors | 
Words 0-13:| SPOOLFILETAPE LABEL-HP3000 
Word 23:| REEL NUMBER (FIRST REEL IS NUMBER) | 
Word 24:] DATE (FROM CALENDAR INTRINSIC) | 


SO SB 8888S 4S 4 0 2OS8E € 062928428046 89040 8 S2E22808 08088 


All other uords are zero. 


File Directory 


The File Directory has one entry for each spoolfile on the tape. Each entry 
is 12 words, and entries are packed into as many 1020 nord records as needed. 
The last record will be padded with zeros if necessary. The entry fornat 18: 


0123 4 § 6 7 8 9 10 11 12 13 14 15 
|n=|-=|-=1-=|-=|--]--l--1-=1-=1-eL=-1-1=={-=1=-1 


| 
| 
Word mo O| OEVICE FILE ID NUMBER 
| 


Words 1-3: | 0 | 
| Words 4-7; USER NRNE | 
| Words 8-11; ACCOUNT KANE | 


| 02-1 File is an output spoolfile 
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Spoolfile Fornat 








| SPOOLFILE BLOCK <---> TUO SPOOLFILE BLOCKS PRCKEO 
| SPOOLFILE BLOCK INTO ONE 1024-WORD TRPE RECORD 


| 
| 
| TWO SPOOLFILE BLOCKS | 


wee names e nee werner es wncweccecccccorceorencenenaransess | 


| TWO SPOOLFILE BLOCKS | 


wenn cece wees es cece teeenesownrescesesserorersnssesewccss | 





The first feu spoolfile blocks have been modified te contain user 
label information fron the spoolfile. This is explained under the 
User Labels Infornation section below. 


Spoolfile Block Fornat 


A spoolfile block is a 512-uord block that contains variable length records 
in spooler fornat. Spoolfile records start at the first word of the block. 
The last record is followed by a -1 to indicate that no nore records follow. 
The last tuo words of the block contain a doubleword which is the record 
nunber of the first record in the block. 


Spoolfile Record Fornat 


28 8 OO 2 OS C OS OS O28 O24 224229424 8S SESTRSESSESETESDOO® 


Word 0:] B6YTE COUNT OF RECORD - 2 


} 

| 

| BYTE COUNT OF CATA PORTION OF RECORD. | 

| NOTE THAT THIS COUNT INCLUDES { 

| TRAILING BLANKS. HOWEVER, TRAILING 
| BLANKS ARE TRUNCATED IN THE ACTUAL 

} RECORD, SO THIS COUNT MAY SE MORE | 

| THAN THE NUMBER OF BYTES ACTUALLY | 

| PRESENT IN THE DATA PORTION. 

| 

| 

| 

| 

| 





Word 2:| FUNCTION CODE: 1 © FURITE 

| 2 = FCONTROL 

| 3 = FOPEN 

| 4 = FCLOSE 

| 2100 AND BEYOND = FOEVICECONTROL 
Word a Pi -- ATTACHIO PARAMETER 
Word § 4:] P2 -- ATTACHIO PARAMETER ! 

Word § my DATA PORTION OF RECORD | 








Spooling 


Device and Class Directory 


The Device and Class Directory is contained in one 1024-uord record. There 
is no EOF separating this record fron the File Directory. This directory 
contains one entry for each logical device or device class linked to the 
spoolfiles cn the tape. Also, there 1s an entry for each legical device in 
each class in the directory, whether or not that logical device was directly 
referenced by a spoolfile. The entries are packed into the tape record one 
after another in no particular order. The entry fornats are shown below. 


Logical Device Entry 
0123 4 5 6 7 8 9 10 11 12 13 14 15 


[==[<=| 
Word 0:{ LOGICAL DEVICE NUMBER 


wet ical sesnee se wen eeaawd aubédeewesceeones | 
Word DEVICE SUBTYPE LENGTH OF ENTRY (3) | 
Uord | DEVICE TYPE 
Device Class Entry 


| 

Word 0:| OEVICE CLASS NUNBER (NEGATED). THIS IS THE | 
| NUMBER OF THE ENTRY OF THIS DEVICE CLASS IN | 

| THE SYSTEM'S DEVICE CLASS TABLE | 


| 
Words 2 On:| THE ENTIRE CONTENTS OF THE DEVICE CLASS | 
TABLE ENTRY FOR THIS DEVICE CLASS | 
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User Labels Infornation 


Spsolfiles have a nunber of user labels with several kinds of infornation. 
These are: 


1, Master: user label 0. 
2. FOPEN entry catalog: user labels 1-10. 
3. Circular queue for restart checkpointing: user labels 11-27. 


Since older versions of MPE did not use user labels, a way was needed to 
incorporate then into the SPOOK tape fornat without losing forward and 
backward conpatibility. The nethod used is to add several special spoolfile 
blocks to the beginnina of the spocl*ile on tape. Each of these blocks has 
exactly one FOPEN record at its beginning. This record is folloued by a -1. 
Thus old versions of APE will assune that the rest of the block is garbage. 
However, the rest of the block 1s actually used to contain user label 
infornation. The first tuo epoolfise blocks (i.e., the farst tape record of 
the spoolfile proper) ccntain o-iy the FOPEN records. The next five tape 
records actually contain user labels in addition to the FOPEN records. The 
user labels are pacned three to a spoolfile block, six to a tape record. 
Each spoolfile block of £12 words has the following fornat: 


| pr eew woe ew mcees- aw Oe OHSS 2ES4 SOL CCE avwaee | 


Uords 6-4: | FOPEN RECORD 
ihc | 

Words X200-2377: ee te ee ee 
Mords 1400-1877: USRLELSS:té‘S;C;C CO | 


USER LABEL | 


SOOO OBO OF £9 8SE46 2S 8 SSSSSOE SOCKS Sra See | 


Words 2600-2777: 


Following this special group cf blocks, the spoolfile resunes a normal 
fornat. The special FOPEN records all have the nunber of user lavels in P2. 


It ie often the case that sone of the 27 user labels have not been 
initsalazed before the tape is ur:tten. In that case, thear places will be 
filled wath gartage. There 19 no easy uay of detecting this except by 
careful inspection. 
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Unified Connand Language 


CHAPTER 15 UNIFIED COMMAND LANGUAGE  (UNCL) 


Reply Information Tab RIT 
DST 234; SIR 725 
12345 67 8 91011 12 13 14 15 


NUMBER OF ENTRIES } 
' MAX NUMBER OF ENTRIES ! 
: POSITION CF NEXT FREE ENTRY SPACE IN QUEUE Lea 
3] MUNBER OF QUEUED ENTRIES | (57 words) 
1 (52 WORDS TO HOLD PINW’S OF QUEVED ENTRIES) | ! 
| UNUSED ! ; 
PROCESS NUMBER (PIN) \ 
" DST# (FOR REPLY) ! | 
Z BUFFER ADORESS (DST eee | 
: MAX LENGTH OF STRING REPLY TYPE EXPECTED | 
‘ DB Offset ! 
5| Ldev 1 | 
|-----nnecnwenccncnenennnenmnnnnnnnmencennccen-=| | 
6| | | ENTRY 
| owen ennnne weenncccncnecccewennoessccroccsooses {| | (51 words) 
yf # BYTES IN MESSAGE | 
| ; | 
| | | 
MESSAGE IN ASCIT 
(UP TO 86 CHARS.) | 
| 1 | 
| | / 
|------- wononsnnnennnnnnnannnernnnnennnennnene=e| 
6.23.00 
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essa a 


Messages in the catalog can be of any length and can contain up to five 

paraneters. Continuation of a nessage is indicated by "Z" or “&" at the end 

of a line. The "Z" eynbol indicates that the nessage is continued and that 3 

carriage return, line feed be issued the terminal. The “&" synbol indicates 
ib the nessage is continued cn the sane line with no carriage return, line 
eed. 


Paraneters nay be inserted into the nessage fetched fron the catalog. The 
paraneters are passed in the GENMESSRGE (or GENASG) call and inserted 
wherever a!" is found. for the systen message catalog, the back slash (\) 
is also a paraneter, reflecting a logical device nunber. The nessage is 
routed to the user asscciated with that ee device through the : ASSOCIATE 
connand. Message sets are indicated by "SSET n” starting in colunn | (the 
rest of the line is treated as a connent). fMaxinun value for n is 63. 
Connents can be inserted in the catalog by placing "$" in colunn 1. Message 
nunbers are positive integers, need not be contiguous, but nust be in 
ascending order. After processing by the progran MAKECAT, the catalog file 
contains records of 8 bytes, blocked 16, in 32 extents. (The systen nessage 
lr art is only one extent, however.) The fornat of the nessage catalog is 
as follous: 


SSET 1 SYSTEN MESSAGES 

1 LOEV @! IN USE BY FILE SYSTEN 
2 LOEV @! IN USE BY DIAGNOSTICS 
3 LDEV IN USE, COLIN PENDING 

5 IS "!" ON LOEVM! (¥/N)? 


$ MESSAGE 35 IS TWO LINES LONG, A PRRAMETER STARTS THE 
$ FIRST LINE AND THE SECOND LINE IS “HP32002" 


35 12 

#?320028.00. | 

276 LEV w FOR “!" GN ! (NUN)! 
SSET 2 CIERROR MESSAGES 


82 STREAM FACILITY NOT ENABLED: SEE OPERATOR. (CIERR 82) 
200 MORE THAN 30 PARAMETERS TO BUILD COMMAND. (CIERR 200) 


2o4 FILE COMMAND REQUIRES AT LEAST TWO PARAMETERS, INCLUDING 
T 
FORMAL WANE OF THE FILE (CIERR 204) 
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NOTE: Procese Nunber = O means entry is enpty 
Reply Type = 0 for nunber (nun) 

1 for yes or no (y/n) 

2 for string (sxx) 

3 for yes, no, or nunbder 

4 for string 

TABLE SIZE = 2046 words 

NAX # OF ACTIVE ENTRIES = 39 

NAX W OF QUEUED ENTRIES = 52 


Ressaage Systen General Description 


The nessage systen consists of the following parts: 


- Callable intrinsic GENMESSAGE 

- Uncallable procedure GENNSG which is used by MPE 

- Systen message catalog (CATALOG.PUB.SYS) and any nunber of 
user catalogs 

- Progran MAKECAT which builds nessage catalogs 

- MESSAGE SIR 224 

- MESSAGE SYSGLOB CELLS 2371-373 

- MESSAGE DATA SEGHENT 


The message systen 18 used by calling GENMESSACE (or GENNSG) with a nessage 
nunber. The message systen fetches the nessage fron a nessage catalog, 
inserts parameters, then routes the message to a file or returns the nessage 
in a buffer to the caller. 


A message catalog is a nunbered editor-type file containing sets of neseages. 
The sets serve to break a catalog into manageable portions. A nessage systen 
user may call GENMESSAGE using eather his oun message catalog or using RPE’ s 

catalog (CATALOG. PUB. SYS). 


After creating a se file, run the progran MAKECAT in order to build 3 
catalog that is readable by the message systen. This file is still readable 
by the a (at can be "texted") but it contains a directory (written as a 
user label). 


In order to use the nessage catalog, the progran must first open the ressage 
catalog, then call GENNESSAGE with the file nunber, set nunber and nessage 
nunber. (NPE users don’t need to cpen the catalog, GENNSG autonatically uses 
CATALOG.PUB.SYS.) The file nust be opened with the sopticne “NOBUF” and 
“RULTI"-record access. 
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ARKECRT Progran 


The progran MAKECAT.PUB.SYS is used to build nessage catalogs (and also HELP 
catalogs). The progran’s input file has the fornat designator INPUT, which 
nust be used for all entry points. The progran has the following entry 
points: 


(no entry - Reads fron input file and builds a tenporary file 
point) (fornal ee ee CATALOG). Also renanes any old 
tenporary CATALOG, CATnn, using an archival 
nunbering echene (i.e., CATI, CAT2). 


BUILD - (Rust hog cn under MANAGER. SYS.) Reads fron 
input file, build the systen message catalog 
(formal designator CATALOG), and installs the 
nessage systen. Existing catalog is renaned 
CATannn according to the sane schene as for no 
entry point (above). Installation of the nessage 
systen neans noving the directory contained in 
the user label of the catalog into a data segnent. 
The OST nunber and the disc address of CATALOG 
are placed in systen global area. The nessage 
systen nay be installed uhile the systen is 
running. 


DIR 


(Must have PA or OP capability.) Installs the 
systen nessage beg (dees not build a new 
one). Opens input file, moves the directory in 
the CATALOG into a data segnent, and places the 
DST nunber and disc address of CATALOG in systen 
global area. This nay be done uhen the nessage 
systen seens to be “broken”, but the catalog is 
intact. (NPE is issuing “MISSING ASG. SETenn. 
ASGenn" at terninals and at the Console.) This 
say be done while the systen is running. 


HELP 


Used to build the HELP catalog. Reade input file 
ee a HELP catalog (fornal designator 
HELPCAT). 
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Ressa sten CATALOG. PUB. SY 


SSET 1 - Systen neseages 

SSET 2 - CI errors and uarnings nessages 
SSET 3 - Miscellanecus ABORT messages 
SSET 4 - Progran error abort nessages 
SSET § - Intrinsics abort messages 

SSET 6 - Run-tane abort nessages 

SSET 7 - CI general messages 

SSET 8 - File Systen error nessages 

SSET 9 - Loader error nessages 

SSET 10 - CREATE error nessages 

SSET 11 - ACTIVATE error nessages 

SSET 12 - SUSPEND error messages 

SSET 13 - AYCONMAND error nessages 

SSET 14 - LOCKGLORIN error nessages 

CSET 15 - Private Volunes error nessages 
SSET 16 - 0S/3000 nessages 

SSET 17 - KELP facility error nessages 
SSET 18 - Graphic devices nessages 

6SET 19 - Serial Orsc error nessages 

CSET 20 - User Logging error nessages 
SSET 21 - Association Utility (ASOCTABL) nessages 
SSET 22 - 2680A Page Printer nessages 
$SET 25 - 2680A Page Printer error File nessages 
SSET 26 - Disc Free Space nessages 

SSET 27 - Systen Internal Error nessages 
SSET 28 - Ciper Device nessages 

SSET 29 - Store/Restore nessages 
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- Kept as User Label 

- Read onto User’s Stack 

- Uses SEARCH Intrinsic Fornat 
- Variable entry size 


45 67 8 9 10 11 12 13 14 15 
[>= |o=[-=1==|o=1==|=-1=-|--1-=}--1--1-- 1-1-1! 
0} DIRECTORY SIZE (WORDS) 


PPB 0088 048 O288OG2ESSEE6 | 6922S SOG88SESE SS COSO2E8OS8 


| 
1] ENTRY LENGTH (BYTES) | KEYWORD LENGTH (BYTES)| 
2 


e2aeoeoee OS OSS OSCE O6SG8 | OSC O8SSSSE GOSOSTSHEHOOOE 


ENTRY | 
KEYUORD ! 


1-255 BYTES 


ENTRY 


\ 

| 
| 
: | 
| 


| 

| 

ENTRY RECORD # IN CICAT | 

FT BYTE | RIGHT BYTE 
| 


280 S08 OSSS4SO8CE88SCEEES | OSE OSOSSS8S4 GEMODETCO | ee heenad 


| 
| 
| ENTRY LENGTH (BYTES) | KEYWORD LENGTH (BYTES) 
| 
| 
| 


eveseucooseescoesecesce | Ccussescsnoaae: seecanwce 
ENTRY | 

” KEYWORD = 
“ 4-255 BYTES ; 
[ 


| 
JENTRY REC @ RIGHT BYTE | ENTRY REC @ LEFT BYTE 


JKEYUORD LENGTH (BYTES) ENTRY LENGTH (BYTES) 
ENTRY 
KEYUORD 
1-255 SYTES 





ENTRY 


! 

| ENTRY REC @ | 

LEFT BYTE ] RIGHT BYTE 
! 

| 

I 





O86 O00 098008 088900S 00868000808 S8OSOS2SSOSSOSSOO 
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- OST @ in SYSGLOB 2373 

- CAT DISC ADDR an SYSGLOB 4371-372 

- Created by running NMAKECAT. PUB. SYS 

- Kept in a Data Segnent and in a User Label 


DATA SEGHENT 











| 
O| MAX. SET @ 10 \ 
| ewene een cnn nnn e nn erenennewene + 2 cee | | HEADER | 
1] ® OF MESSAGE RECORDS ? / 
| wecceesnacwccesc avecseeoocceccoucsec= 
2| RECORD OFFSET TO FIRST MESSAGE j2\ | 
| enenrnaececonnncenenweneennneenonee= | SET 1 =| USER 
a FIRST MESSAGE 13/ LABEL 
4] RECORD OFFSET TO FIRST MESSAGE I4\ | 
| monn nnww ewww nn ene wenn nn enon nnnnnnnn= { SET? I 
t FIRST MESSAGE @ \ / 
| | | 
~ EMPTY ENTRY . 
: a 
GO| RECORO OFFSET TO FIRST AESSRGE {40\ | 
| cocennn ene wen nnn nnne ne wene ren enennn= } | SET 63 | 
51] FIRST MESSAGE # el 
52| 0 [42\ | 
| -eeeee encecenee ceewecewcececenoeenno= | | CUR ASG | 
= RECORD OFFSET TO CURRENT MESSAGE a3 | 
54| NESSAGE \44 
| BUFFER | 
~ (640 WORDS) ze 
1253] {683 
Jonocecerecee= meercwerncwnnewnnenenne=| 
EMPTY ENTRY: 
| RECORD OFFSET OF NEXT IN-USE SET | 
| -1 | 
|occceeweee cconeeccerenoenensecenerere | 
6.23.00 
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YOC Directory 
- Extra Data Segnent - DST @ in 08+Z255 of URRIN Stack 
- Built by INITUOC 
| 123 4 5 6 7 8 9 10 11 12 13 14 15 
ARM Coed Raed Rated Rated Cored ated Gated Gated ated ated Dated Catal Gated Gated aed abe | 
fe eal bat | Wd ENTRY SIZE : 
HERDER RECORD NUMBER 
] BODY RECORD NURBER 
| FILE NUMBER | COMMAND LENGTH ! 
i | } > 
| | CORRAND 1] 
| 7 WANE = 
| ~*~ (1-16 BYTES) ~ | 
i | 11 
; | \/ 
[reer ccencweren ena: sonewennwecnnessoconcccenneoe | 
, 4 | 
i J ] 
| ~ ENTRIES : 
| 4 ! 
7 | 
1 LAST ConnAKo ENTRY | 
| a ae 
| | 
! [UST ENTRY (12 WORDS OF ZEROS (0)) ! 
| = ae 
; 4 | 
[  fecweconnnewememecarn nnn [ eweecneccenweseean sence 1 
| [ 0 | ENTRY SIZE=O 


|eneaennnenenennen-nnnne |o-nenn-ennncecncncnsnce| ENDS DIRECTORY 


LT = OPTION LIST 
LN = OPTION LOGON 
Ne = OPTION NOHELP 
ho © OPTION NOBPEAK 
TYPE = OO - USER LUC 
01 - ACCOUNT YOC 
10 - SYSTEM UdC 
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Unified Connand Lanquage 


YOCs COMMAND. PUB. SYS 


- Record Size = 20(10) Words, 6 Records/BLock 
- Keeps track of uho is using what UDC Catalog 
- Can be purged to disable UDCs 

- Can be rebuilt to re-enable U0Cs 


Z RECORD O # af FREE ENTRY # 
Ol1ST FREE ENTRY # [0 O[NEKT FREE ENTRY #10 
enn! es oo ee 
1] NOT USED \1 " ENTRY TYPE=O i 
| eaeeaeuvaweoeooeoeouwoeefo 8 }3}3]3}3;+xf fe@eeeean ie Ae OS Oh aE Ep a Te ee ae 
2| Max IN USE l2 st < 

3] # IN USE 3 - MOT USED . 
4] 14 | | 
| OT USED ! | | 
: : | | 
- | { 
| | | | 
= Ve a a 
Z USER ENTRY ] Z FILE ENTRY ‘ 
O| CATALOG ENTRY W/O O|NEXT CAT. ENTRY ly 
11 ENTRY TYPEs1 = |1 1{ ENTRY TYPE=2 : 
6.23.00 
15- 9 
Unified Connand Language 
k Definiti 


3485 6 7 8 9 10 11 12 13 14 15 
Jon fo=|==[-=1-=[-=]-n]=-1--1==1-=1--f-=1-=1--1=] 
08+Z0| SCONIARGE (BYTE PTR. TO COMMAND) 


28S OC OOS © 8 ©2828 OSOSSSSBOSS8S OSE SSS CESZOEOTOOCTFZ“LOSO | 


08+Z1) COMMAND INAGE | 

~ (280 BYTES) - 

| ésodbnwsoosaccaccccesess egesnnace ccccdccconeencoucs 
0842215] LINELENSTACK | 

“ (30 WORDS) . 

| pron nen wwe nen ennenccccoeone or coceorenccensnene | 
0B+%253] NEXTMSG (NOT CURRENTLY USED) 
DB+%254| (NOT USED) | 
pie | uDcO 
08+7256] { uocs 
DB+Z257/F LI sss } uoc2 
0B+Z260| LI] UN|NH|NBt | upc3 
besxeeilrelee lak |itt | NESTLEVEL | uoc4a 
uae: IFNESTING | 
usta IF SKIP | 
DB+Z264] ELSESEFN , | 
DEZ265] \sa| hal CIF LAGS 
0867266] CONTINUE | 

|--- STATE ---| 
aWaes?| STACK ! 
ueszzi0| PENCIN-COMLEN ! 
ieee BLAS"TOMIPAGE (BYTE FTIR.) 
06+Z272| LAST COMMAND IMAGE ! 

~ (280 &*TES) ie 

| coe ren none nn nnn omens + poem mene nenne nen encnn =| 

6.23.00 
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Unified Connand Language 


UDCs COMMAND. PUB. SYS (Cont.) 


| | 
Z| 2 2| l2 
| USER* | | FILE NARE | 
3] 13 3| 13 
| | | FOPEN FORMAT: | 
‘ r 4 
ss 
6| 6 . FILE ig 
| 
ay ACCOUNT* : . { /LOCKUORD} ? 
10| : ” GROUP : 
| 
11| : " RCCOUNT ‘ 
| oeneennnenenmsoe 
12| es a 0 a4 
| 
" NOT USED Ad ae jh 
14| 112 14| 112 
| | | (UP TO 36 BYTES)| 
a Ne et fig 
ie ha fi 
a" Hee ad tas 
“I ve et a 
21} \1? 21] \17 
| } | | 
= _ ae fd 
23 119 23) 119 
| | ! | 


- If the User Field and the Account Field contain "@_ se", 
this indicates Systen Level UDCs. 


If only the User Field contains @ and 7 spaces, this indicates 
Recount Level UDCs. 
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Unified Connand Language 

Field Definitions 

BCONIMAGE - Byte pointer to CONINAGE (sonetines called 
UCOMIMAGE) in the CI stack. 


COMMAND IMAGE - Connand character string currently being executed. 


LINELENSTACK - A CI connand can span up to input lines. 
This stack holds the length of each input line. 


NEXTASG - Used to be used to link messages together. 
No longer being used. 

UdcO - Holds the OST nunber of the UDC definitions. 

UOC! - Holde the old S register value for UDCs. 


UDC2: (0:1) - FLUSHUDC, used by :SETCATALOG 


UDC3: (0:1) - CPTION LIST = 1 
(1:1) = OPTION LOGON = 1 

- GPTION NOHELP = 1 

- OPTION NOBRERK = 1 


) 
) 
UDC4: ) - UOC Fatal CI Error 
) - UOC EXITBREAK 

) - UDC BREAKDETECTED 
- UDC NOPRINT 

6 


- UOC IMAGERDJUST 


IFNESTING - Level of nesting of :IF connands. 


TFSKIP - Uhether the current connands are being skipped 
as the false part of a :IF cennand. 


ELSESEEN - Level of the :ELSE connands. 


CIF LAGS: (13:1)- Sequenced: line nunbers at rear. 
(15:1)--Not REDOable (last connand). 


CONTINUE STATE STRCK: Nistory of the :CONTINUE connande: 
# 0 - No :CONTINUE 
s 1 - Just seen 
s2- In effect 


PENDINGCONLEN - If <> 0, connand is already in stack and this 
word is the connand string length. 


BLASTCONIMAGE - Byte pointer to last connand inase. 
LAST COMMAND IMAGE - Uhen a command conpletes execution, the connand string 
is copied here for use by the :REDO connand. 


6.23.00 
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Unified Connand Language 


Agsociatiocn DST Layout 








|} oO] jo OST 242 
i 1 \1 
{ 2] NOT \2 SIR 23 
1 3 \3 
} 4] USED \4 
| SI 15 ONE ENTRY/ 
| ‘ : SYSTEM LDEV 
| 7] JMAT INDEX 4 \ 
| ae JIT OST NUMBER ; | 
} 11[ OST REL. INDEX TO USER'S NEXT ENTRY 9 ‘i Ldev 1 
| -ooneeennee 28 OSS £20628 22280 BESS 2GSE04860 @Seeseon 
(ASSOCIATED) 
| 12] CLASS NAME UNDER WHICH THIS LOEV IS j10 | 
} 13) ASSOCIATED> LEFT JUSTIFIED AND hh ee | 
) 14]  PADOED WITH BLANKS. 8 BYTES. (12 | 
| ae f 
| 16] 0 114 ; 
| i 0 115 
| = 0 tag I LOEV 2 
| (UNASSOCIATED) 
| 2% (17 | 
| 22] UNDEFINED 18 | 
| 23 19) | 
| 24} j20 / 
| ---envennnnnnnanennvnnennenncncnenennnnne=| 
| | 
| | | 
| JMAT INDEX OR O s } 
| JIT OST NUMBER OR O | 
| NEXT ENTRY POINTER OR 0 . LEV a 
| CLASSNRME UNDER WHICH LDEV IS | | 
| ASSOCIATED OR UNDEFINED. | | 
[ ] / 
| -----non-----~---ennnnnnnnnnnnnneennmn nnn | 
6.23.00 
18- 13 
Unified Connand Language 
Fornatted Ca F truc 
----— on—---—---| 
RECA °| OVERHERD 
RECH 1] | 
\- CACHE DIRECTORY “| 
|------ --------—-| 
RECW HCI 
{° MESSRSE CRCHES | 
| | 


| 

RECH m4 
|- OATA -| 

| { 

| { 

| 


Uhere: MC = 2 + (2 * Mnessage caches )/128 
D = AC + (384 * Wnessage caches )/128 


Each physical record is one sector long (128 words). Each structure starts on 
a sector boundary. 


6.23.00 
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Unified Connand Language 


Appli ion Message Facilit 


The Application Message Facility consists of tuo parts: GENCAT, the catalog 
naintenance facility, and the "CAT" intrinsics, through uhich the nessage 
catalogs are accessed. The “conpiled” catalog, uhich GENCAT creates, 
contains an extensive directory at the front of the file which describes 
uhere every nessage in the catalog is located. lhen a nessage catalog 18 
opened (via CATOPEN) part of this directory 18 read into an extra data 
segnent which 18 Created specifically for that purpose. This “caching” of 
the directory provides nearly direct access to the desired nessage. 





These nessages include nessage set nunber, message nunbers, and record 
nunbers placed or "cached" into 384 word nessage caches. The first set 
nunber and nessage nunber of each message cache is placed into a cache 
directory (set and nessage nunters nust be ascending). A message is found by 
scanning first the cache directory, then the nessage cache searching for the 
desired set and nessage nunber. The retrieved nessage directory entry 
contains the record nunber in the catalog file of that message. Now, the 
catalog file can be read directly using the record nunber. 


Internally, the two layer directory format is used by both the fornatted 
application nessage catalog, and the message extra data segnent created by 
the intrinsic CATOPEN (and used by CATREADS 


The catalog files created for MAKECAT and GENCAT may be used with the 
Application Message Facility. In most cases, applications will increase 
their perfornance in message routing and decrease the file space with 
formatted catalogs. 


a-YocnnnnYoneennaV-n2nnVonnewnYorennneVonneaYonnnn==VonrenneVe-=| 


| 
JDATA | DATA | DATA] DATA | CATR | OATA | CATA | OATR | SATA | 


The naxinun catalog size ie 65536 sectors long. The largest set nunber is 
sen The eecuees neseage nunber is 64766, while the snallest set and nessage 
nunber is 1. 


6.23.00 
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Unified Connand Language 
Cache Directory 


Each entry in the cache directory is a tuo-uord entry. There exists cne 
cache directory entry for each 384-word nessage cache. The first uord of the 
cache directory entry is the set nunder of the first entry in the associated 
message cache. The second uord of the cache directory entry is the nessage 
nunber of the firet entry in the associated nessage cache. 


| -----a-nann-veneon=nnenm-=-| 

| 1ST SET NUMBER OF CRCHE 1 |<-| 
|nnnenennnewnnnwennecnnnnnn=|  |-CACHE DIRECTORY ENTRY 1 
| 1$T MSG NUNBER OF CACHE 1 |<-| 

| 1ST SET NUNBER OF CACHE 2 |<-/ 

emcees wceccecensenne=|  |-CRCHE DIRECTORY ENTRY 2 
| 1ST MSG KUNBER OF CACHE 2 |<-l 

| | 

[- -| 

i ! 


| 
| 1ST SET NUMBER OF CACHE N |<-| 
| he OP Ep AD Gt POPS OPE oH Oe GE Ge OS HS eee | | CACHE DIRECTORY ENTRY & 
1ST WSG WUNBER OF CACHE WN |<-| 


99090 O8COS8COCOSS4 288882828 
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Unified Connand Language 


fessace Cache Fornat 


Each message cache is 384 words long (3 records). A message cache entry is 3 
uords long, 128 entries per message cache. Each entry contains the message 
nunber and set nunber of the nessage. The byte offset is the offset to the 
start of the nessage in the record specified by the record nunber. Entry 127 
is a duplicate of the first entry in the next cache. This is to allow the 
total nunber of bytes of the message to be conputed without reading the next 
nessage cache. 


| enone nn newennononnowernenne= | 

! nESSAGE pate ia (eeee= | 
SET NUMBER BYTE OFFSET ! sear 0 ! 
| RECORD NUMBER ice | 
| | | 
|- -| |-CRCHE 1 
| | | 
| -reenen enn no ee nwn nn nnennee= | | 
MESSAGE KUNBER \<- | 
! SET NUMBER | BYTE OFFSET | |-ENTRY 128 | 
| RECORD NUMBER is (ecens| 
| | 

l- -| 

: : 

| MESSAGE NUMBER |<- (oeees | 
SET NUMBER | BYTE OFFSET | |-ENTRY 0 | 
| RECORD NUMBER |<- | 
| ennnn nnn nn nm wwe en eonnnennne | [ 
| | | 
|- -| (-CACKE N 
| | | 
| --------------- coccecconcn| | 
| MESSAGE NUMBER A 
| SET NUMBER | BYTE OFFSET | ‘eels 127 | 
RECORD NUMBER . (eccee | 

6.23.00 
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Unified Connand Language 


Hessa T Overh 


| seeeeseseaaeuee | re | 


) | "0 |ROST* ID 
1 

a” Sge OF sT (IN uORDS ) |ost’stz 
a” cavnuae FILE WOWER——_(rosT-caT-F 


4} OFFSET TO RESIDENT CRCHE |MDST’RESIDENT’ CACHE 
S| OFFSET TO CACHE DIRECTORY |MOST*CACHE’DIR 


6| OFFSET TO ASG DIRECTORIES |MOST’NSG’DIR 


7| CACHE DIRECTORY SIZE (WOS)|MDST’ COIR’ SIZE 


| 10| MSG DIRECTORY SIZE (UDS) |MDST’DIR’SIZE 
i BO 
| 12] RECNUN OF FIRST MSG DIR. |MDST’FIRSTOIR’ RECKUN 
| se spi 
| 14| RESERVED | 
| -erenn nnn enneenenennccennen=| 
6.23.00 
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Unified Connand Language 


Qata Fornat 


The fornat of the nessages is straightforward. It contains only the text of 
the nessage. It contains no connent records, nessage nunbers or set nunbers. 
All leading and trailing blanks are stripped fron the nessage. 


Message DST (MOST) Structure 


A message extra data segnent 18 allocated during a CATOPEN. The data segnent 
nunber 18 kept by the application on the return fron CATOPEN. The fornat of 
the data segnent is similar of that of the fornatted nessage catalog. The 
nain difference is the addition of a table to track resadent caches in the 
OST, and the catalog data 1s not kept in the OST. 


Message DST Overview 


| --nn------n-n-nennnnenenene l 
| |ROST’ OVERHEARD 
| MOST OVERHEAD | 
| | 
| {MOST RESIOENT' CACKE 
|- MOST RESIDENT CACHE AREA -| 
| | 
| | MOST’ CACHE’ OIR 
]- MOST CACHE DIRECTORY -| 
: 
| MOST’ ASG’ OIR 


MOST RESIDENT MESSAGE 
CACHES 


NOTE: A resident cache is a nessage cache copied fron the fornatted catalog. 
Resident caches are suapped in and out of the MOST and are used to deternine 
the record nunber of the desired set and nessage. 


C.23.00 
15- 18 
Unified Comnand Language 
Nesss T Resident Cache Area 


The Resident Cache Area is a table of the message directory blocks currently 
stored in the NDST, together with their index. They are held in order fron 
the nost recently accessed at the top and the oldest on the botton. The 
naxinun nunber of caches held in the MOST at any one tine is MOST’ CRCHE’ MAX. 


| 
| INDEX OF CACHE DIRECTORY | 
| MOST RECENT ACCESS CACHE | 


MOST Cache Directory 


Each entry in the cache directory is a tuo-uord entry. There exists one 
cache directory entry for each 384 word message cache. The first word of the 
cache directory entry is the set nunber of the first entry in the associated 
nessage cache. The second uord of the cache directory entry is the ressage 
nunber of the first entry in the associated nessage cache. 


wee cowcwcnenses cseccecocceces | 

| 1ST SET NUMBER OF CRCHE 1 |<-| 

|onnnen enn nnennn nec encennnne | |-CRCHE DIRECTORY ENTRY 1 
| 1ST MSG NUMBER OF CACHE 1 |<-| 

| 1ST SET NUMBER OF CRCHE 2 [<-| 

| --nnen--nnn---ennennennn=ee | |-CRCHE DIRECTORY ENTRY 2 
' ¥ST MSG NUMEER OF CACHE 2 |<-| 


See o O28 SH SBS SCSeESOSC BO HESTT ORS 


| 1ST SET NUMPER OF CACHE N I<-| 
arate elas ira annem | |-CRCHE DIRECTORY ENTRY N 
| 1ST MSG NUMBER OF CACHE W {<-| 
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Unified Connand Language SYSOURP/INITIAL 


HAPTER 1 YSOUNP/INITIA 
CONFORTA File 


ROST Message Cache Format 


Each message cache is 384 words long (3 records). A message cache entry is 3 


uords long, 128 entries per nessage cache. Each entry contains the nessage R 0 NFOATA Fi CTABO 
nunber and set nunber of the nessage. The byte offset is the offset to the 
start of the nessage in the record specified by the record nunber. Entry 127 6012 3 4 5 6 7? 8 § 10 11 12 13 14 15 


is a duplicate of the first entry in the next cache. This is to allow the 


total nunber of bytes of the message to be conputed without reading the next O| CHECKSUM OF CTAB (REC 0) 














nessage cache. aaa alalatatataaatae | 
1] CURRENT VERSION OF CTAB |" 
[oon roconcecoceoone wocnees-| 2| STANDARD STACK SIZE |2 
| RESSAGE NUMBER |c- ate | | 288268 SOTSHHSSOSHZOEL CBSE OS SSS S288 22282880088 | 
seeccwanooces | cocecconcesce | 3| CORESIZE IN K WORDS {3 
| SET NUMBER | BYTE OFFSET | |-ENTRYO | | pre e nec ec ecw woenennnnnenoconncccoeowcrsocooce | 
enmescsococce | coccccoccorce | 4| TERMINAL BOUND PRIORITY \4 
| RECORD NUNBER |<~ | | penn cnn nn en eno rnen nnn co nernnennnnecnnocoenncone | 
errr et ae ern ! , NORMAL PRIORITY is 
. "| Nga 1 | CPU BOUND PRIORITY . 
sem cccoconsecesescecescsore | 7] @ OF SECONDS TO LOGON \7 
| MESSAGE NUNSER \< | | ennence cow nn nnn nnn n nnn enn nnn enne rn on eecoennwce 
secwsconcoene | moc ccccoescen | 10) LOG FILE RECORD SIZE (SECTORS) (8 
| SET NUMBER | BYTE OFFSET | |-ENTRY 128 | | eon n nec e we cwn ewww cewooneennnoee wren ncosccoooncn | 
| prow enw ennnee | cown nc enecene | 11] LOG FILE SIZE (RECORDS) 19 
| RECORD NUNSER \<- Coseee| | prec ec own wwe ccencenennn sewn enecnncscnscconcoce 
| woe wrenennnanoneo nnn eneenes ta He 
|- -| $3) LOG BITS (ONLY 11 USED) {11 
| | 14| 112 
| eonmeecceece seeccsonocecere | 15] <cDEFINES WHAT I$ BEING LOSGED>> {13 
| MESSAGE NUMBER I< Ceccce | 16] \14 
weeccenccecce | ewoweceorccne | 17| {15 
| SET NUMBER | BYTE OFFSET | |-ENTRYO | | ewewneneencnnnnnncnencenseecnenseccocoerosecwe= | 
sewcceneocce o | -oenecccewcce | 20} DEFAULT JOB/SESSION CPU TIME LIMIT 116 
) RECORD NUNBER te ! Cece ccnwewene econ anaansesoosoorosaceere sceceec= | 
| | | ° ° 
l- -| |-CRCHE N |nonvernncne wocrnnrnnencewnce nen nnnnneeeeenecnene | 
| 34| =MAXINUA OPEN sPCOL FILES fgg 
| MESSAGE NUMBER I“ = hes 
| SET NUABER | BYTE OFFSET | |-ENTRY 127 | 36| 130 
wecenecwncone | comncoecoocoe | | | MAXIMUM @ OF SPOOL FILES (KILO SECTORS) | 
| RECORD NUMBER is Ceeeee| a 131 
| ize 
” @ SECTORS PER SPOOL EXTENT e 
6.23.00 6.23.00 
15- 21 16- 1 
SYSOUNP/INITIAL SYSDUNP/INITIAL 
Rec 4 NFOATA F TA f CONFORTA Fi TR 
| 0 1 45 6 7 8 910 11 12 13 14 15 
|--|--|--]-=l---=1--1--1--1--1--1--1--1-=1-- 1-1 |--neowvonnnone= wonneeenncencenconcene| 
* @ OF CST ENTRIES i 36| MAXIMUM CODE SEGHENT SIZE ja 
i. @ OF OST ENTRIES \" 37] MANIMUN @ OF CODE SEGHENTS/PROCESS ha 
2) @ OF PCB ENTRIES [2 Bee AAXINUA STACK SIZE (RAXDATA) = 
3] @ OF 100 ENTRIES ? 41] RAXIAUN EXTRA OATA SEGHENT SIZE {33 
_ # OF TERMINAL BUFFERS “ 42| MAXIMUM @ OF EXTRA SATA SEGHENTS/PROCESS e 
5] # OF CST EXTENSION ENTRIES . . ie ° 
6) INTERRUPT CONTROL STACK SIZE (Q1 to 21) 16 | poeo www wc ewewmcowocnncne secewewcecceneennne eo | 
www ewww nnnennnn nnn non - nan cnnwncenenerenerscence 60| MAXIMUM # RUNNING SESSIONS \40 
7| + @ UCOP REQUEST OUEVE ENTRIES |? meweeweweneneencnceeccee rec eneneeseneoecesocce= | 
wonnwcens cw nence conn ccoes coceccce wwocwceesnccce| 51| NMANINUN @ OF RUNNING JOBS {41 
10] @ BREAKPOINT ENTRIES 13 need encageeensesvens peswrrssesenennssosesacooes | 
a oad §2| % LOG PROCS {42 
11] @ TRL ENTRIES 19 Joreee- ssanes mower eres ennenne cess o=| 
wenccccwnc cccnwcccwcccecoweececenccewosnescence | §3| LOG I0’s 143 
12| @ OF RINS [10 a ata | 
| eoecemenernne son cenenneennn---ccnne wovecencoece | S4| @ DISC REQUEST TABLE ENTRIES 144 
13] @ GLOBAL RINS 111 wowrencccncosccewererccocncccoccccenn ren oncnees | 
cecceccescacuecccsses eeeeeceseccscceeecconccece §5] @ SPECIAL REQUEST TASLE ENTRIES 145 
14] @ OF SYSTEN BUFFERS {12 en ree ee ee ee ee ee ee 
eadwcdsendanccacceoccccsace | 66] @ PRIMARY MESSAGE TRALE ENTRIES 146 
15] @ OF CONCURRENT PROGS \13 srccreesecenncnnnncescocceneerweneeweconeeens~| 
| pee w ena nn nn nn enn n-ne w ew nn nnn eee wenceceoccescon 57] @ SUAP TABLE ENTRIES |47 
16] LOADER SEGNENT SIZE 114 eewrcecnncewe ne cn swnnerernnenecereeneseeneccees| 
| [cocccenccccceeecnerecnwnerwennenensennonncorso= | a @ SECONDARY NESSAGE TABLE ENTRIES ja 


| OSS OS OC 6 CSS BOSS CSO SOSS OSS 6 SOS O88 O8OBSOEDSBOHOTOSOD ! 


24| SIZE OF VIRTUAL MERORY _ 
ie DIRECTORY SIZE (SECTORS) jz 
G. 23.00 
16- 2 
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SYSDUNP/INITIAL 


INITIAL/PROGEN Connunjcation OST 


The INITIAL/PROGEN Connunication data segnent is used by Initial to pase 
information to PROGEN. This segnent is only tenporary and not nenory 
resident. 


COMMDSTN = SYSGLOBEXT (2122) DST (SYSGLOBEXT (Z122)) 


01234 5 6 7 8 § 10 11 12 13 14 is # 


meg pe pod eod ed pod be bel ed oD 
/-----| POINTER TO THE START OF CTABO | 


| is 

lie POINTER 10 THE START OF CTAB f 

t | SYSTEN START-UP OPTION 2 OPT 

t ! RECOVER LOST DISC SPACE PROGRAN : Recovery 
}1 | RESERVED | 

il 

\- 


DESCRIPTIONS 


OPT = Start-up cpticn Recovery = 1 If Recover Lost Disc Space 
0 = Uarnstart 
1 & Coolstart s 0 If Not Recover Lost Dise Space 
2 = Coldstart 
3 = Update 
4 = Reload CTAB & CTABO - See the descriptions of CONFDATA 
file in this chapter. 


The microcode will store the CNTRL 8 connand into (QI-11) equivalent to 
(RBS(5)-11) for the Series 37. 


CNTRL B O = Start 
1 = Uarnstart 
2 = Coolstart 
Z10 = Load 
Z11 = Update 
Z12 = Coldstart 
X13 = Reload 
Z14 = New 
220 = Bunp 


Starttype = ABS (RBS (5)-11) 


6.23.00 
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SYSOUNP/INITIAL 
FOATR T kup Fi ntry Fornat : 


612 3 4 5 6 7 8 9 10 11 12 13 14 15 


| /e-*12|DEVICE CLASS KATE LIST POINTER (ENTRY RELATIVE)| 


eseecesn: SPE GRE SSP EP ED CE PP PE OM @ 9S OOO DOSS S OS QSODROOVWSMOO® 


| 
|  [/--13{TERMINAL DESCR. FILE NAME POINTER (ENTRY REL.) | 


-14| DEFAULT OUTPUT DEV. OR POINTER TO DEVCLASS | (ENTRY RELATIVE) 


22202920 SS SSE S828SSEE SOEEE8 9222802288820 4282088080 


15| CS LOTX ENTRY POINTER (CURRENTLY SET TO.0) = | 


SOO SS OSS CO O88 SSE 8 9 SSE 88248 02S 488 S9E8SEEE6 EEE CES8E2 











uhether the 
output device 
is given. 

AlsOefault Ruto 
Increnent (ORT 
or Unit) 


AR=Ruto Reply 


| 
W/ 
itt 
ith 
iI 
| it 16] RESERVED 
| Ht MI OEVICE ID COOE 
| Ht a RESERVED 
1 UI) 21] RESERVED 
II] Jeneeeee- wecweceen | eee eene-nn-|-=|--|--]--]-----| ; 
1 tf 22] OEVICE TYPE | SUBTYPE {3 | AL I] Ol SS | JeJob Accepting 
Wtf | AzData Accepting 
| | IsInteractave 
| | D=duplicative 
oe fon SS$3Spool State 
| 23| CHAN. @ICRIOS|SQICLIAZ! RECGRO UIDTH | CR=Core Resident 
| | DS#0S Cevace 
| | SQ*Spool Queues 
| CleIndicates 
| 
| 
| 
| 


24| OEFAULT TERM. TYPE |AR| RESERVED 


saeeceeneoueeanen eeevee | c@ fj 002 ©2828 FOS 088222 208 S80E" 
ene oe2eee2: PEP EE EDS OPS OS BSS SSS DS GSES SVHAHBOACOO 


SSO C © 6 OOOO E20E 88S C2 O48 OC 8 OGSOESSE 084248 698600228088 


7| RESERVED 


8 C8 8 OOO S SOOO S4 9892S 0S OSO8E 28 OES SSSSO2SSSSSS4SEE"2 


| 
| 
| 
| 
| 
5| TERN SPEED | 
| 
| 
| 
| 
DRIVER NAME | 
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SYSOURP/INITIAL 


DEFOATA Table Lookup File 


This file contains the default information for HP-supported devices. This 
file, DEFDATA.PUB.SYS, 18 available to Sysdunp and Initial and elininates the 
necessity for looking up default information every tine a device 18 added to 
the systen. Oespite its nane, DEFOATR.PUB.SYS 1n not only a file, but a 
table in the Coldload Information Table. It 18 not easily modified. 
Therefore, it 18 reconnended that the file be left alone; if any user is 
unhappy with the defaults, they can be overridden during the Sysdunp or 
Initial dialogues. 


DEFDATA Table Lookup File Header Fornat 


0123 4 5 6 7 8 91011 12 13 14 15 
i ga al 


CHECKSUN 
Jee | 
Saimin | 
\mvaucre, oe 
‘ames 


DEFDATA Table Lookup File Entry Fornat 


123 4 5 6 7 8 9 10 11 12 13 14 15 


0| | 

| | 

‘| | 

| | 

‘ DEVICE NANE | 

3| | 

| | 

4| | 

| i 

5| | 

| | 

6| | 

| | 

| 

| 10| TOTAL DEVICE ENTRY SIZE (IN WORDS) | 
| 11|@ OF DEVICE CLASSES FOR THIS DEVICE (SET 10 1) 

6.23.00 
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OEFOATA Tab) okup Fi n Fornat nt. 





1 ott = 
1 ttl 33 | 
| | | | eoco men snmnnnne ssececseecnensosvercres | 

1 I\->341- -| 
| | i TERMINAL CESCRIPTOR FILE NANE z 

| 2 Semeerensngmamaae 

| |: TERMINAL DESCRIPTOR GROUP NANE ‘| 

| [eee ee Se ase 

| J- TERMINAL DESCRIPTOR ACCOUNT NANE “| 

| | [oceececrenncennnn-cneenonneecene connennwerennnn| 

| \-->I- -| 

| : QUTPUT DEVICE CLASS KANE | 

| | pov nn nn nnn nnn nn enn nnnn nen eeerwennnnnneneocone| 
\s--->]- -| 

fi DEVICE CLASS NANE 

ween ene ee nn nnn een nw ewe weeeseccoeee | 

| RESERVED | 

| enn ew nnn enn - nme enn ncn ewecn ween enennnenncre| 

6.23.00 
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DEVOATA. PUB. SYS 

vervieu 
|--nnnn-nnevennnneenneeeeon | 
| PARAMETER RECORD | 
aver ILE 
are | 
ord 
| UTX | 
[cuss /icn venOeR | 
es eet 
ime 
| mob. OR THOU 
i | 
SiMe 


Paraneter Reco 


| FOSS S8SSSSE €88S0SE 4446820808008 | 


O| CHECKSUA | 
vse - 
ler | 
3 nesT ON g 
Meet aT 


| WR. ROD’ L ORIVERS | 
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SYSOUNP /INITIAL 
Driver Table 


The Oriver Table consists of 7 ucrd entries, in correspondence to the LDEV 
entries, up to the highest LDOEV used, entry zero is a dunny entry. 


345 6 7 8 9 10 11 12 13 14 15 





of 
[=~ |-----ec=|--nenoen] == |---re=- soereen= 
1/CR] CHAN & | {DS} UNIT @ 


| oo | eevccecce | eveecece | oo j seeweoceswenesescoooooos | TYPICAL ENTRY 


2] MASTER LDEV | FORRAT 


3| h) | an | 


aj I | v | 


| OD OP Oe Pw OPS SSS PEO ED | 8 PSS SS ©2922 95824555528 


S| " | a 


| OOS OP SSS SASS S OTS SOSD | PPP BS SOO SSOSS SHS SORTS | 


2O8OSS CFS S8 ©OOSESSG2S4E8 | OS POS OSOSS8 2S 2PF2STSE2ER2 





dS OS DEVICE (if set ORT is zero) 

CR CORE RESIDENT 

CHAN @ CHANNEL # 

MASTER LDEV LDEV of device which thie DS device is linked to. 


Uords 3-7 contain the driver none. 


SyspUnP Format 








|<---ENTRY POINT @1 (ROM BASED 
° MACHINES) 


| 8 2 29S8S9SE 29 FOSS: 


| CHECKSUM 
| AMIGO CHANNEL PROGRRA 
--| UCS TRBLE PRT 


to next CHECKSUM 
RAT 


| |enenennn-nooeeno eee wecwrenecnneccccencne | 127 
| ANIGO 
oe WLS TABLE 
| “yes a1 | 
| CHECKSUN * | * Rppear only if 
| @NAIGO | SYSUCS64 is 
eat er ee present. Skips 
j 
| 


——— 


SYSDUNP/INITIAL 


Paraneter Record (Cont.) 


| 
7100] REC # 


OVA TABLE 
| LENGTH | 
no2] ROW OOC~S~*S |LPOT 
1 LENGTH “| 
inne [oT 
| LENGTH - 
mos) REC ee ey [WoT 
| LENGTH a 
mol mew oct 
| LENGTH “| 
meee ictass 
| LENGTH 7 
ji. [TERN DEF 
| LENGTH "| 
zie] RECW# ~—~—~—~—~*CSWRDO LOW 
| LENGTH | 
nol “eC “ies DEF 
| LENGTH | 
m2zj RCW OO™~S~*S cS TABLE 
| LENGTH | 
|onncacnncnenversnanennens 
F 
£200|- UNUSED “ 
6.23.00 
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SYSOUMP/INITIAL 
SYSDURP Format (Cent.) 

|--nenvnnnnnnnn-nneennnannennncneennenene| 
| UCS #2 | Only for the 64/68. Refer to the 
| eevee nnn n nn cnn mn enon cones en nn nen scononse | UCS Table for the 64/68 belou. 
} WCS aN { 
| pone new nnn nn nn mm en nnn wn cn cer conenenen= [<---ENTRY POINT @2 (UCS BASED 

CHECKSUN [0 ARCHINES) 

AMIGO 


acwncccccccareneenecncnocnanennnsceesoee [127 


RAIGO | 
a ee as 
ae 
“aa 
SK aaa 
|oevice cunss Tao veROER | 


| VIRB 
! OLOV7RB & 
CSC COLD LOAD INFORNAT=ON TPBLE | * 
| CTAB 
| enon nnn een nae nnew ener enn nn nnn ceneewonnn | 
| ¢TRBO 
| COTRUNICATION RECORD | 
| csove 
| CSOEF | 
pis been cea wescuceseccceeetasencasccounese | 
6.23.00 
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SYSOUNP/INITIAL 


YSOUNP Fornat (Cont. 


} STACK MARKER | 
an | 
ea ee | 
it lee aaa. | 
Tier can AC | 
sos | 
ame \ 
I TaGGING IDENTIFIER TABLE ne 
mane \. 
Gai. |. 
ae ee | 
| SvSTEN PROGAANS, SL, NONCSTD. DRIVERS | 
ee | 
\STORERESTORE HERDER | 
co pepag ae | 
I -sToRE/RESTORE DIRECTORY | 
oe | 
[amen FAS (Sepa BY "EOF'S™ | + 
I STORERESTORE TRAILER | 
or geaicesra cect | 
— 
ago ee | 


& WOT DUMPED IF DATE = CARRIAGE RETURN 
Note: On disc, READ-SIO-PROGRAN kept in Disc Label. 


6.23.00 
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Series 37, 37XP and 37 Micro UCS Table Fornat 


Three entries (Entries 5, 6, and 7) used by Series 37, 37xP 


and 37 flicro. 

| coveeownn | eno er en wrn nnn nnn | eown no nenoeronnn 
{128 WORD | UCS | ut | 
JHEADER =| 


| 999090 O98 080280 OOOOSE08 C8 SS HEH SBETD BOO DOOTTOS 


Ol MICROCODE VERSION (8 BYTES ASCII) | 





11] WUT CHECKSUN | 


! 

! ! 
| 3| | 
| $ # OF UCS LOCATIONS (64 BIT WORDS) | 
el 
| 6| # OF LUT LOCATIONS (32 BIT WORDS) | 
im | 
| 10] UCS CHECKSUN 
| 

| 


Store Tape Fornat 


First Volune 

| wom ewnnnen enn en nnn nnwn wee nen enn wns emnnonn | 

| €OF | 

|eonnn nnn nn nnn nnn n wenn n mene nme nen ennnnnnnee | 

! EOF | 
| O| “STORE/RESTORE LABEL-HP/3000." 10 
| 15] had 
| 16| “VITB" 114 
| m {15 
| 3 PARTIAL FIRST FILE FLAG is 


6.23.00 
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ey oe oe ane ee ee ae gt” 


SYSOUNP/INITIAL 


| 
} # RECORDS TO uCS * | 
| # RECORDS OF UCS | 
| ® RECORDS AFTER UCS | 
| UCS RECORD SIZE ON TAPE 


8S SO SS 6 CSO BOO OOF BB BOSSES O84 E BOS SDOHSAOOOS 


| 

| 

| 

| 

| 

| 

| 

| [eseseseeeee chdtieeseeasternotecssanaee sens | 

| 2 \2 
1 | -wene-nonnnenennwnnnnennnenenneerrennnnone| 

| 3 \3 
| |ooneennennnrwnnnennnnnennnnnnnnenncnecces| 
| 4 14 
aera ere ! 
| 

| freee wee nn nn een w nw en emeewnsoweroreccorseree 

| 145| |37 


® If SYSUCSE4 is present, WUCS records following =O. 
If SYSUCS64 is not present, the preceding entry is repeated. 


Seri x/70 WCS Table Fornat 


One entry (Entry 4) is used by Series 6&4, 68, and 70. 


| 
1128 WORD | 
\HERDER 


[ 

1 ol 

| 3 : 
| ‘ # OF UCS LOCATIONS (64 BIT WORDS) ! 
| cece wewereen nce cccw er en swe ccocesnnasesense | 
| | @ OF WT LOCATIONS (32 BIT WORDS) 
| ee ereronncncwccccecereweroncons coreweenene| 
| 10] SLOW WCS CHECKSUN | 
11] FASTUCS CHECKSUN | 





PBA SDD DD bP aa a | 
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t nt 
[enowewececee= | | 
| 24] CHECKSUM {17 | 
| 22] DIRECTORY INDEX OF FIRST FILE {18 =f 
coacacacsecaeccnenccenwcencecessscvecesces| | HERDER 
| 23] |19 | 40 woRos 
~~ 
| 24] \22 | 
| 27] VOLUME NUMBER 123, | 
| | OATE (24 | DATE: 
ace eecceccee {| 0:7 last 2 digits 
} 34] TINE 125 of year 
| | 126 7:9 Julian date 
| 33] TAPEBLOCKSIZE (WWORDS/BLOCK;DEF*24096) [27 | TINE: 
| -eewenenennneneneeecnnennenneoenncewennees | 25. (0:8) hours 
| 34] j2s | (8:8) minutes 
7" e { 26.(0:8) seconds 
| ; | (8:8) .1 secs. 
| si i / 
| €0F | 
aaa aaa 
| . - 4 
|oeooneee ecececcecennanenenenenenensecenaee| | 
| FILE NANE I\ | 
|nnneaccoreccoceseccencnnennncnecenenmenme=| {TYP FILE | 
| GROUP NAME 1] ENTRY | VOLUME 
accccnncencancccennenncncenesecneceencone=|](12 MDS.) | DIRECTORY: 
ACCT. NANE | @ ENTRIES 
| | DETERMINED 
je : | BY TRPEBLOCK- 
| . ; / SIZE 
| €0F | 
| eoeen ene n meen nn nnn nnn own nonce nwcewewcennca| 
FILES 


| 
| FILES (SEPARATED BY “EOF’S*) 
| 


ag, Oe ewes ge 


6.23.00 
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SYSOUNP/INITIAL 
Subsequent Volures 
| eroeeennnonenceonseece woccccenenssocoon= <-| 
| O] “STORE/RESTGRE LABE L-HP/ 3000. “ jo \ 
| a = 
| 16| ‘“vIIe" [14 | 
| ne hes 
| 20] PARTIAL FIRST FILE FLAG 116 FLAGe1: =f 
| erocewceeneonnno= eesncncnsenscesesstenens= | tet FILE | 
| 24| CHECKSUM 117 ON THIS | 
| eononnnwnenecnneennnennncerenneseeeneenene | voLIsa | 
| 22| OIRECTORY INDEX OF FIRST FILE 118 PARTIAL. | HERDER 
annnwenenennnnennnnnnnncesneennnnnnnnencen | 40 uD. 
} 23] {19 | 
| se |22 
| 271 VOLUNE NUMBER {23 | 
| | DATE i | 
| 31] TIME (25 | 
| a \26 
| 33] TAPEBLOCKSIZE tad 
| Xl j28 | 
| a ” / NOTE: NO EGF. 
| <° . a \ 
| . | 
| peoconccwccccewcwcwcsnnsooccoocosnoncnccn= | | 
| FILE NANE IN | 
| ewo-cenoee ecownnccccconcccccose concecccone |i TYPICAL | 
| GROUP NANE {| PILE | VOLURE 
| poo n nme mown en nnnenn co cce wenn noeesennoonn= || ENTRY | DIRECTORY 
| ACCT KANE / | 
aca | | 
} < : ~ | 
1 < / 
| pence nnn new ce nw enen nnn nen nnceweroncncre nee | 
| €0F | 
j 00898 OOOSOOSSE 6 OOS 8 08686808 S2680S0SS8 SS SOS COTO | 
| | \ 
| <FILES> | | FILES 
| (SEPARATED BY “EOF’S) | | 
cowccoreenenscecocowcre eewecwnnnanceconn=| / 
6.23.00 
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CHAPTER 17 NISCELLANEOUS 


dT t 


The NPE labeled tape subsysten pernits convenient access to tapes labeled to 
either ANSI or IGM standards. It operates ao a set of subprocedures to the 
file systen. A labeled tape consists of cne or nore logical files. Each 
logical file consists of three physical files, i.e., tape areas delinited by 
tape narks. The first physical file contains header labels, the second 
contains the data, and the third contains trailer labels which are (except 
for ninor differences) copies of the header labels. The tape nark following 
trailer labels will be followed either by header labels for the next file, or 
by another tape mark if there is no next fila. Labels are 8 bytes long, and 
conventionally are identified by their first four characters (three letters 
and a digit) and contain infornation as follcus (CP := character position; 
L:= length): 


VOL1: Present only on the first file of a volune, the volune label contains 
the volune identifier, which is usually the nunber on the tape strap, and is 
thus not expected to be changed. 


[er | eee YC eee 
[ava | weet ioewririer tao | 
[a tue wae ee 
“Shot wime erie | etvu | 
ar [aeeessenarty TV son ty tse | 


| 
| 
| 
| 12/79 | NOT USED | 62 | BLANKS 
| 
l 


| 
80 | LASEL-STRNDARD VERSION | 1 | "1" IF HP ANSI ELSE" “ 


80 990080800 06008 0000 6 OOS OOSOe & BOS OSS CESS 6 OOS BOSSES SEO OSSD O DIS 


Wn: User volune labels. May be present on tapes fron foresgn chops, 
but are not uratten by MPE. If encountered, they are igrored. 
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End of Volune 

| ence enone nnn ncmw en cnwennncownsnmosorreerr= | \ 

| | | 

| <FILES> | | 
| | (SEPARATED BY EOF’S) FILES 

| | / 

| eon no nc cc nnn nmenneenn enon oreocnnwonrenoeen | 

| EOF 
| O| “STORE/RESTORE LABEL-KP/3000." |0 \ 
} 15] 13 | 

| sessosennsessescescen= cowenawssecososocor~ | | 
| 161 114 | 

| | | 
| “ ag 
| et FLRG: PRECEDING EOF MARKS FILE ENDED ie | TRAILER 
| 7 FLAG: PRECEDING EOF MARKS TAPESET ENDED ie 40 UDS. 
| 27] VOLUME NO. |23 | 
| a DATE ie 
{ 31] TINE j25 | 
| a hae 
| 33] }27, | 

| | | 
j 47] hg / 

{ EOF | 

[coeeccccerccececcecore worececcccnonececens | 

| €0F | 

| eon nnn nnn ence nnn nw nw nr ennnncnenecnnccoenn| 

|  €0F | 

| pone nn meee new n enn ennconnnnnecowconecnenorn | 

6.23.00 
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fliscellanecus 


HDR1: First header label. Required for each file and specifies: 



































|--o---- | -oeceo ence cweneneoeceenn | enna | cores { 
| cP | FIELD NAME It CONTENT 
| 1/3 LABEL IDENTIFIER } 3 | “HOR" ! 
| 4 | LABEL NUMBER 1 ie | 
| | | | FILE WANE, IF TRPE WAS NOT | 
| 5/21 | FILE IOENTIFIER | 17 | WRITTEN BY APE, ONLY THE = | 
| FIRST EIGHT RRE SIGNIFICANT | 
| 22/27 | VOLUNE SET IDENTIFIER | 6 | NAMES THE VOLUME ON WHICH | 
\ | THE SET OF FILES BEGINS [ 
| 28/31 | REEL NUMBER | 4 | COUNTS THE REELS THAT i 
| | | CONTAIN THIS FILE (1 STARTS)| 
| 32/35 | FILE SEQUENCE NUMBER | 4 | COUNTS THE FILES IN THE SET | 
| | | OF FILES (1 STARTS) 
} 36/39 | GENKUN ! 4 | ALUAYS "0001" ! 
| 40/42 | VERSION ! 3 ALWAYS "00" | 
| 43/48 | CREATION CATE | 6 | YEAR AND OAY WITHIN YEAR = | 
| | | | WHEN THE FILE WAS URITTEN 

| | | YERR AND DAY WITHIN YERR = | 
| 49/53 | 


EXPIRATION ORTE | S | WHEN THE FILE MAY BE OVER- 
| | | WRITTEN WITHOUT PERMISSION 


| 
| 54 | ACCESSIBILITY | 1 | 2290 IF LOCKWORO, “O" IF In} 


@eeaeeaoe ee | @ oe CPCS © COO SSOSOS4ES2OSSE80 eeee SS O8SOOSE 088 CONSE S OSS HSSSESESESEO 


| $5/60 | BLOCK COUNT 6 | NUMBER OF BLOCKS IF IBA { 


| 61/73 SYSTEN CODE | 13 | “KP APE 3000 “ 
} 74/80 | NOT USED | 7 | BLANKS | 
cococee | eenanannnnnnnnneocwenece [anne | eonennnnnnneneceeneneneeeenne| 
6.23.00 
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HDR2: Second header label. Although defined by the standard, nay be 
missing on foreign tapes; it contains: 


| | | 

} cp | FIELD WANE L CONTENT | 
|------- | cone nn nena nn nese nen ennn [oven [eon me seen nnnweweeoncencrorcne 
} 1/3 | LRBEL IDENTIFIER ! 3 ! “KOR” 
|[------- | poem nn nnn nnn nn rn nn eo nnn = | eoen | coowewnrreenwownnreroweoorrn= 
i 4 ! LABEL NUMBER ! 1 "2" 
ss | [| ve” = FIRED 
|} § | RECORD FORMAT { 1 | "Vv" = VARIABLE | 
| | | | "U" = UNDEFINED | 
| | | | OTHERS TREATED AS UNDEFINED 
|-oneoe- | een nme n nnn nn no wenen sens | cone | eoecnncerewecsoneeorernoserre 
| 6/10 | BLOCK LENGTH |} § | BLOCK LENGTH (IN CHARACTER | 
| | ! FORMAT) | 
| 11/15 | RECORD LENGTH | § | RECORD LENGTH (ROHERING TO | 
| | | TO MPE RULES) IN CHARACTERS ! 
esoscee | eoennnnnennnseeeenceren= a re et 
| 16/23 | LOCKWORD 8 | MPE FILE LOCKWORD | 
|oon---- | penn nn nn nnn nnn ee nnn ones | omen | enon on enencocceseeneeosocoore 
| 24/36 | NOT USED 13 APE WRITES BLANKS 
| cocwcwn | concen se ccwewnwwccocece | once | cwecocncocwoocoscssoossece aeaoe 
| 37 | RECORD TYPE {| 4 4 "A" = ASCIT | 
| "Bg" = BINARY 
|-re---- | roc enweeennnnw ncn e scenes | once | core rnecconecnesccos waeerwecee 
| 38 | CARRIAGE CONTROL | 14 "C" 3 CONTROL 

| “" = NO CONTROL 
| 39 OLKSIZE=RECSIZE? 1 | YES="R", NO2"6" ! 
| 40/49 | NOT USED ! 10 ! BLANKS 
| 50/51 BUFFER OFF ! 2 ! ALWAYS “00” | 
| 52/80 | NOT USED | 29 | BLANKS 

6.23.00 
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User header labels: optional. Standard prescribes Ulin in the firet 
four characters, but fPE doesn’t care. 


E0V1: End of Volune; used as first trailer label. Required if the 
logical file is continued onto another reel. Identical to HORI, except 
contains the nunder of physical blocks of data in the data area. 














cp | FIELD NAME j} ul CONTENT 
| 1/3 LABEL IDENTIFIER | 3 “E0v" 
4 LABEL NUNSER 1 “" 
5/54 ! SAME RS HORT | 50 | 
| | | | NUMBER OF DATA BLOCKS SINCE | 
| 55/60 | BLOCK COUNT | 6 | LAST BEGINNING OF FILE { 
SECTION LABEL GROUP 
| 61/80 | SANE AS HORI 20 





E0V2: Defined by the standard, but nay be nissing on foreign tapes. Follous 
EQV1; format sane as HDR2. 


EOF: End of File: used as first trailer label. Required if this is the end 
of the logical file. Fornat sane as E0V1. 


EOF2: Sane as E0V2 except used after EOF. 


User trailer labels: optional. Standard prescribes UTLn in the first four 
characters, but NPE again doesn’t care. 
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IBN has a slightly different fornat which 18: 


| 
} cp | FIELD NAME L | CONTENT ! 
|------- | ennnennnnnnnnnnnn nn nnnne | oo nn | eonnnnnonernnnnnenrerececercs 
| 1/3 LABEL IDENTIFIER 3 "KOR" | 
| eccccce | coc cccw ew cw ccc ccnoccoen | ccce | eoecec eres crensnesersoorrrree 
} 4 LABEL NUABER 1 ! nae 
| mccc cen | coco cw wne ence eww snocowce | cone | coon ooecseon cesses nsoroosorore 
| | | | “FY = FIXED | 
| § |{ RECORD FORMAT | 1 | “v" = VARIABLE | 
| | { } "U" = UNDEFINED | 
| | | OTHERS TREATED AS UNDEFINED | 
|------- | cenensennnnnnecenenscen=| ore | mocen enn me renenencensesonen= 
| 6/10 | BLOCK LENGTH | § | BLOCK LENGTH (IN CHARACTER | 
| ! ! FORMAT) | 
| 11/15 | RECORD LENGTH | § | RECORD LENGTH (ADHERING 10 | 
| | | | TO NPE RULES) IN CHARACTERS | 
|-o-oee- | eonnn nce men ne nnononennne | cone |-onnnnenenern en nnneennnnrcrn= 
16 | NOT USED | 1 | BLANK | 
| 47 | IBN POSITION 1 4 | "0" = NO VOLUME SUTTCH | 
| | ! "4" = A SWITCH KAS OCCURRED | 
ewccece | commen nn nn nnn enoonennee* cone | ewe we wwccwewecc cnn cceccncoece 
| 18/38 | NOT USED | 1 | BLANKS | 
| | | | "g" = BLOCKED RECORDS | 
| 39 | IBM BLOCK ATTRIBUTE | 1 | "S" = SPANNED RECORDS | 
| | | | "R" = BLOCKED AND SPAXNED | 
| | ! “" = WO BLOCKED OR SPANNED 
| 40/80 | NOT USED | 41 | BLANKS | 
|--eee-- | eon nnn en nn cen cenncowenoe | cove | en me nen n owen eeennn ncn ennocene | 
6.23.00 
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Tape Label Table 


The tape label table is the private playground of the tape label subsysten. 
It consists of tuo parts: LDEV Control Blocks (UCBs) and Volune Control 
Blocks (VCBs). The LDEV area is set up at systen initialization and contains 
one entry for each magnetic tape LDEV and serial disc device in the systen. 
As is connon in APE, the firet entry is a dunny which tells uhere the other 
things in the table are. The volune area contains one entry for each labeled 
tape volune requested or active on the systen. 


Although table entries are stored in an extra data segnent, they are 
generally manipulated via local copies on the stack. The procedures GETLDEV 
and GETFRUN look for LDEV and volune entries as specified; they copy then to 
stack buffers and retum the DST address for use in copying then back. 
POSTVTENT copies the entries back, and in the case of a new volune entry, 
allocates epace for it in the volune section of the tape label table. 


Initial will build the “uninitialized” TLT as follows: 


34 5 6 7 8 9 10 19 12 13 14 15 


|--|-<-] --- |---| --- |---| --- |---| --- woe |---| ---] ---] --- | --- f---| 


SIZE OF THE TABLE, IN UORDS (ALWAYS > 1) 
| NUMBER OF LOEVS IN THE TABLE = X ' ? 
LDEVa \T 2 





LOEVe {T [Xe2 
aac’ SPO OS OSS SSS8 © SCSSCOFESESSO8CESST2 FESS SCS | ee 
” EXPANSION AREA S 
“ DURING SETUP’ TAPES es 
| 


T: 1 if Tape drive 0 if not Tape drive (i.e., seraai disc) 
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During PROGEN, SETUP’TAPES 18 called to initialize the table. The overall 
structure of the initialized TLT 1s: 


TLIOST -- 232,826 TLTSIR -- 247,039 
12 3 4 § 6 7 8 9 10 1 12 13 14 15 


Pee peed pe ed Ped be bed bcd ped eed bed ed ed oe oe 


| | 
TABLE INITIALIZATION WORD (=1 WHEN INITIALIZED) 


| SIZE OF TAPE LABEL TABLE, IN WORDS (VTMAX) is 
£0008 0h 5e en 0ee ee Fees 2s eeeeenn canna nscnnassseeanncsannsacese | 

| 16 

| | 

| |? 

| | 

{ }10 

| | 

* NOT USED 7 

| | 

| |30 

| | 

| {31 

| ponnnwmenmmncccccceneneccencnccncrnnren enn ennnmnnwowweennaccens| 

| (32 

! |<-(1) 
~ UDEV CONTROL BLOCK AREA -- ONE ENTRY/RAG TAPE ORIVE . 

| | 

| | 

| own ewew rn wee nnn nnn en ewownconncce seece renew eenenowecewccencenwce | 
ae 
“ VOLUME CONTROL BLOCK TABLE -- CONTAINS VCB ENTRIES 2 

; AND FREE ENTRIES 1 

| | 
[orenecene= eeccerore Wemmemererennnenweccosoencnwec rer weeccocoece | 

| ie 
~ AREA AVAILABLE FOR EXPANSION OF VCB TABLE 2 

| | 

| | 

| pocon wenn enc en ew ew en cnw ren ccw ewan nn wesseserescnsersnoncscoce <-| 
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Type: 00 ® No tape nounted 
01 = Unlabeled 
10 = ANST 
11 = I6f 
L: 1 if file has lockuord. 
T: 1 if device is a tape drive. 
8: 1 if tape is fron Burroughs, uhich has incorrect bleck/record size 
in the HOR2 label. Code can be patched to correct the size. 
HP: 1 if tape is Hewlett-Packard ANSI fornat. 


VCB address: Pointer to VCB entry describing volune mounted on 
tape drive, only if linked. Otheruise, 0. 


ee ew Vee 


fiscellanecus 


LC8 Entry Fornat 


The LLB entries have the following structure: 


34 5 6 7 8 9 0 11 12 13 14 15 


| TYPE | T{ LC | 8 | HPI 
| Iscoleqelesel 


| LOGICAL DEVICE NUMBER 11 
[Ven ee ay, 2 
aa ae 5 
Pri aan i 
ee ee is 
aaa \6 
| |? 
ilies pe I10 
EE ir 
| 


: P 
LOCKWOROD i 
ad 
al 
te 
| 
VOLUME SET IDENTIFIER ee 
| |30 
| ---veeeeennnnnnnennnnnnennnnnnennnanneenennncennneennnnnnnennen | 
| ‘ 
VOLUNE IDENTIFIER fal 
| 133 
|----nanvornnwenennnnecnnnnnnnnnennneneeeennennnnnnnnnnnnnmnnnee | 
6.23.00 
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veR Entry Format 


The VCB fornat ie: 


012 3 4 § 6 7 8 § 1 11 — 13 14 1§ 


eee | eee jeeeies2e | aeoe | eee | ewe | eee | aa | wee] eee one] aaa | oes | eee | see | 





{x 1]F | 8 | POSITION | W | SEQTYP) LBLTYP} L | HI RB IO 
fy a aaauaeie ak cue aR alll 
a eee ee 
\ He we TOM 
| FILE SEQUENCE KUNBER ake i 
ete te eer fue anes 
aM irae c 
lawman a 
[Relorflué 110 
eet 


Do CHD SD Dh ODDS SPOS OP PSPSPS 9S SOSS SS O08 SSSSSSOSSSSESCOSSHSSESOO | 


| 
| 
i 
| 
| 
l 
| 
| 
| 
! 


ty 
[23 
LOCKWORD 

i 

\25 
|-=------- nornennenccnennenecnnnncennnanenetannanennanennnnnnnes | 
| : 
VOLUNE SET IDENTIFIER i 
: » 
: P 
VOLUME MANE ie 
| |33 
| -nenanna-nnnnnnnnnnnnnnnnnnnnnnnennnnnnnnnneenennnennnnennnen=e| 
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Miscellaneous 


KX: All Files Expired 
F: Flush bit - cperator did REPLY <pin»,0. 
A: APPEND access 
Position: Gives head position within logical file. 
© = At load point (LOPNT) 
1 = HOR) label mext (HINX) 
3 = After HOR2 label (RH2) 
4 = After user header labels (RHU) 
6 = Data next (ONX) 
7? = After data (AD) 
8 = EDF1/EOV1 label next (T1NX) 
10 = After EOFZ2/EOV2 Label (AT2) 
11 = After user trailer labels (ATU) 
W: Urite access specified. 
Seqlyp: File open sequencing type. 
0 = Match filenane 
1 3 NEXT 
2 = ADOF 
3 = Use file sequence nunber 
LblTyp: As in LCB entry. 
L: Linkwait - nark left by CREATETLTENT for LINKLABEL. 
f: Mount wait - waiting for operator to nount tape on FOPEN. 
R: Reel suatch wait - waiting for next reel. 
B: Busy bit - this entry is in use. 


LOEV W: Logical device nunber of tape drive with this volune, only if 
linked. Otherwise, 0. 


S: STORE tape. 

R: REELSWITCH has been done. Used by STORE/RESTORE to handle STORE 

label and directory file. 

D: Next file is directory. Used by STORE. 

Density: volune set density. Ouring a volume set open, contains the 
density requested by the user in FOPEN. Once the volune set is 
open, contains the actual density of the volune set. Only 
valid for tapes on variable density tape drives. 

0 = Default density for volune set open 
1 = 1600 BPI 
2 = 6250 BPI 
V: 1 if volune set 18 being opened. Reset after conpletion of FOPEN. 
U: User legging uarnstart recovery file access. (Set only during file open.) 


Volune Recognition 


Volune recognition is the responsibility of DEVREC, uhich reads the first 
record of a newly-nounted tape on an uncuned drive and passes the record to 
RVREC. AVREC nay see: VOL! in the first 4 bytes, in ASCII, in which case the 
tape is ANSI; VOL! in the first 4 bytes, in EBCDIC, in uhich case the tape is 
IBN; Anything else, in which case the tape is considered unlabeled. 
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If an EOT reflective nark or an EOF in data is found, REELSUITCH is called 
(principally fron the file systen procedure IOMOVE) to call for the next 
reel, if any. If another reel is needed, the tape drive is set Unouned so 
that AVREC will be called to recognize the new tape when it is mounted. 
REELSWITCH returns to its caller when it is satisfied that en appropriste 
tape is nounted. 


Closing Files 


FCLOSE calle CHECKUL to handle writing EOF! and EOF2, if needed, and 
resolving the tape position. If the disposition is 3, the tape is left 
positioned at the next file. If the disposition is 2, the tape is supposed 
to be left at the beginning of the current file, but the code does not 
estes provide for reel switching if the present file began on a prior 
ree@i. 


At present, ensuing volunes of 2 nulti-volune eet must be mounted on the sare 
drive as the first, nostly because neither the file systen nor STORE/RESTORE 
was capable of dealing with LDEV changes in the niddle of a file. REELSUITCH 
reports the LDEV being used, houever, so that the capability of using a 
different LOEV can be added in the future. 


Store/Restorg 


Conplications ensue on labeled STORE/RESTORE tapes because there needs to be 
a file directory at or near the beginning of each tape of a nulti-volune set; 
RESTORE uses this directory to deternine uhether the epecified file(s) can 
exist on this tape. Secause the reel switching process would otheruise be 
invisible to STORE/RESTORE, especial bits (VCB’RSWDONE and VCB’URITOIR) are 
kept to enable special intrinsics callable by STORE/RESTORE to report uhether 
a directory needs to be written or is about to be encountered. 


The special procedure NEXTTAPEFILE is used by STORE/RESTORE in lieu of doing 
a FCLOSE(,3) followed by an FOPEN to get to the next file. This permits 
cleaner handling of both REPLY © and Forward Space (logical) File over a Reel 
suitch, as well as saving the tine needed to tear doun and reconstruct all 
the control blocks. 


PVOLID is used by the SKOUDEV connand processor (in SPOOLCONS) to obtain the 
nane of the volune on the specified drive uithout having to know the 
structure of the tape label table. For the sane reason, TGETINFO is used by 
the FFILEINFO intrinsic (in FILEIO) to get labeled tape infornation. 


Systen Failure 86 in NPE is defined as a najor problen in LABSEG. Generally 
speaking it is a problem with the TLT setup, for exanple if LABSEG cannot 
find an LDEV in the table. 
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If the tape 1s unlabeled, AVREC reports to DEVREC that no further action is 
required. If the tape 18 labeled, AVREC wants to see the first HDR1 label, 
so asks DEVREC to read another record. (Unfortunately, OEVREC cannot be 
stopped long enough for AVREC to do its oun read.) When the KDR! record is 
found, the volune entries can be searched to see if there is a pending 
request for this volune. If so, the waiting process 18 restarted. 


If the systen has been restarted with tapes nounted, there will not be 
interrupts to alert DEVREC. The procedure RECOGNIZE 1s called when needed to 
see if any such tapes exist. 


Cpening a File 


FOPEN gets into the tape label code in three different places. The first is 
to call CREATETLTENT, which parses the string passed in the FORNSNSG 
paraneter to identify the labeled tape file required. If there is no 
existing corresponding entry in the volune area, this is 2 volune set open, 
and a new volune entry is created. There may be an existing entry (if the 
tape was FOPENed and FCLOSEd with disposition 2 or 3), in which case there is 
an associated LDEV entry for the drive on which the tape was left mounted by 
the prior cperation. In this case, the neu information is stuffed into the 
existing volune entry. A bit (LINKWAIT) is left set to mark the entry for 
LINKLABEL. 


The second entry 1s through LINKLABEL, which is called fron ALLOCATE. At 
this tine, it is necessary to identify the LDEV to be used for the tape. If 
no LOEV is associated, the LOEV entries are searched to see if the operator 
has already mounted the required tape. If so, the volune and LDEV entries 
are cross-tied and LINKLABEL is done. If the search turns up nosh 
suitable, the operator is requested to mount the appropriate tape. Then the 
procedure waits for either a REPLY or for RVREC to discover the appearance of 
a custable tape and restart the process. If the operator enters a reply, it 
is validated. 


The third entry is through POSITION, which is responsible for positioning the 


tape to the requested file. At the file, the HDR1 and HOR2 label are 
exanined as required to deternine the file characteristics. 


Reading and Writing Files 


All procedures uhich move tape go through the catchall procedure CHECKUL, 
which takes care of necessary labeled tape doings. The code insures that the 
sequence: header labels (including user labels), data, trailer labels 
(including user labels) 18 maintained. There is a separate CASE leg for each 
such procedure. 
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Breakpoint Table 


DST = (10) = 236 
The break point table is divided into 2 sections: 


1) PCB BREAKPOINT EXTENSION TABLE (PCB’GKPT*EXT) 
This table contains the heads of the breakpoint chains. 


2) BREAKPOINT ENTRY TABLE (BKPT’ ENTRY’ TRB) 
This table contains the actual entries. 


Genera! Layout 


“\-\-\-\-\-\-\-1-1-1- 


| 
| 
| 
| 
| ) 
| Seetrenray'Tas | 
i 


| 


SYS GLOBAL 
14:15 


225 | |LIS| | 
| I-t-1 


L = Table locked 
S = Systen bresk | 
points exist | occ eene cence enewee om 
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| - 
| # ENTRIES | ENTRY SIZE = 1 


| HERD SYSTEM LIST {| FREE ENTRY = 0 


| 
USER ENTRIES 





ENTRY (0) 
| ota uotos aRERKPOIWT TAB | 
| | leap FREE St | 
acct aa 
jaan 
ama 
|--enorennonn ---| 

LAST ENTRY 
aaa cana 


| ® USED USER ENTRIES ACTIVE ENTRY = Index fet Entry 


in breakpoint 


chain 
II FREE ENTRY 
u SIZE | 
| FORWARD LINK | 
| GRCKUARD LINK | 


SOS OSGOOOS SE COSTE SSEOESOS 


The breakpoint entry table consiste of variable length entries. 


The nininun entry size is 7. 


ENTRY(O).(0:1) © FR: 


ENTRY(O).(1:1) © Ps 


ENTRY(O).(2:1) # L: 


ENTRY(O).(3:1) = V3 


ENTRY(O). (4:1) 2 Ds 


ENTRY(O).(5:1) = Fs 


ENTRY(O).(6:1) = Ts 


ENTRY(O).(7:1) © U: 


ENTRY(0).(8:1) = Pils 


ENTRY(O).(9:1) = Cs 


ENTRY(O).(10:1) ® UP: 


ENTRY(1).(0:1) = ff 
ENTRY(6) = LINK: 
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Free Entry 
1 = Freee 
0 = Used 
ia Rode Breakpoint 
1 2 PRIV. 
0 = NON-PRIV 
Process-Local Breakpoint 
1 © Procese-Local 
0 # Systen 
Validation Bit 
1 = Instruction In Entry(3) 
© = Instruction Not In Tab 
Deuble Trap 
1 © Breakpoint Oscillates Betueen 
P/P+1 
0 ® Not Double Trap 
Fake ‘Dunny” Trap 
1 © Breakpoint At Pet 
© = Breakpoint At P (Orig. Lee) 
Two Word Instruction 
1 © Tuo Word Instruction 
0 = Not Two Word Instruction 
User Label Present 
1 = Trap To User Supplied Label 
0 = Trap to DEBUG 
Pernanent Breakpoint 
1 = PE 
© © TEMPORARY 
Condition/Count 
1 = Cendition/Count Specified 
0 = No Cond/Count 
Updating 
1 = Entry In Process Of Geing 
Updated/Renoved 
© = Not Being updated/Renoved 
User PLRBEL Node 


Link 
0 = End Of Chain 
= Index Next Entry 


6.23.00 
17- 17 


Niscellanecus 
Active Entry 
| y11itg 
0123456789012345 
f-l-l-fed-led-telelel-l-t-t-l-t-l 
JOJPILIVIOIFITIUIPICIUI SIZE | 
Orr edd tb ean tel 
L-f-f-l-f-[-f-t-f-l-t-f-t-l-1-t-I 
ol UNUSED 
2] SLOCKLABEL | 
3) | 
|--neonnnnnennnencnennncnnnnnnee | 
| " PLOC 
7 INSTRUCTION 
. LINK 
| 7| USERLABEL I\ 
|--nneeennnnnnnnnnnnrneennnne ---1 | 
| | 
a CONDITION/COUNT 2 variable 
| i | 
| ---2n--nonnnnnoneennnnennnenne= L | 
| COND CESCRIPTOR | 
|--enwcrennnennnennnnnenennnnnen 1/ 
6.23.00 
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Retive Entry (Cont.) 
ak Tabl 
COUNT CONDITION 
my ORIGINAL CNT. - OPERAND1 | 
| @ OF HITS | | OPERAND2 | 


jOPT1|OPT2| RELOP |} 


| PPADS SPER SGSSSOBGSSISOSOSD 


' 1 


RELOP -> (8:8) RELOP NUNSER: 
3 = UT 9 = LTE 
4 = 61 10 = GTE 
§ = EQ 11 = NEO 

OPT? -> (0:2) OPERANDI’S TYPE 

OPT2 -> (2:2) OPERAND2’S TYPE 


QPERAND TYPES: 
© -> CONSTANT (SINGLE UGRD) 
1 -> ADDRESS (DOUBLE WORD) 
3 -> INDIRECT ADORESS (TRIPLE WORD) 


OPERAND FOSHS: 
CONSTANT <-> | -----------] 


CONST | 
RDDRESS -> |----- |----- | 
| REG BRSE | 
| OFFSET | 


REG => (0:6) CORRESPONDING INDEX INTO ‘REGY’: 
3° 2A 10 = OL 
4 = SY 112 Q 
7 = OR 1228S 
8 = 0X 172 €A 


9 = 08 
BASE -> (6:10) SEG 4/BANK @ 
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fiscellaneous 
Tiner Request List (TRL 


The systen clock interrupts every 100 ns, with the CR being autenatically 
cleared. An exception is the Shared Clock Interface neasurenent service 
which allows rates as fast as 5 ns. The anterrupt handler 16 the procedure 
TICK. On entry, 0B 18 pointing to the base of tiner request list. Besides 
tineout requests, the clock also controls tine slicing. 


| 177111 
| 0123456789012345 
| l-f-}-l-f-l-l-l-I-l-t-1-f-l-1-l-! 
| | NUMBER OF ENTRIES 
) a] ENTRY SIZE (4) | 
ENTO|  [ennnn nomen nnn nnn enn nce nnnnennne | 
| FREE LIST PTR | 
\ W OF DAYS SINCE LAST START  |HP-I8 SYSTEMS ONLY 
( i QUANTUN/100 AS JQTINE 
| 5] | 
| | TINE OF ORY* {DTINE® 
ay st 
\ a YEAR { JULIAN DAY | 
| Ape: PTR TO MOST ACTIVE REQUEST  |HEAD 
J11] TRACE WORD | 
ENT2| | enccoennccennne weocweenereceoce | 
| \424 0 | 
| | \OUNnY TINE 
| \13] 0 — Jeceeceeese 
| |-]--connecoree=  etebatetatettananetenetanal { 
Hap CODE ! INDEX OF NEXT | ! 
| {15| &6 | | 
ENT3| | eon nw ene n nnn ne nnn nn nn ennoeeeen= | ASSIGNABLE 
j TINE TO SERVICE AFTER ENTRIES 
\ | REQUEST IN FRONT (UNIT= 100NS)| { 


FOSS OS SSSO COSSSSSOESHSOSSHSFOESSOESO | 


222 OSOSSOE82 2EOOSSSSSS2SHSSSSHhO2OEO | @2eeneeoneen 


A: O if inactive request 
1 if active request 
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IPE User Legging enables users and subsystens to log changes to data sets on 
disc or serial files. Thas “change file can later be used to recover data 
lost due to a systen or progran failure. The leg file can itself te used for 
auditing purposes. 


nera ian Overview 
Hardua nvironnen 


No special harduare is required to operate the systen. Houever, if logging 
to a tape file is desired, the harduare configuration must include a tape 
drive. If there is no tape drive, then it nay log to a serial disc class 
device. 


oftua vironnent 


NPE User Logging is an integral part of fPE. No other special softuare is 
required. 


Desiqn Narrative 


User Logging enables users and subsystens to journalize add.ticns and 
nodifications to APE and sutsysten files. The journal can reside on either 
disc or serial log files. 


User Logging consists of a logging process, a nenory buffer, a disc resident 
logging buffer (for serial logging) and a user defined destination log file 
on disc or serial nedia. 


The logging process has tuo functions depending on whether the destination 
file resides on disc or serial nedia. If the destinat:sn file is serial, the 
logging process perforns all output to the destiretion fyle. If the destira- 
ticn file is on disc, the logging process allocates additional space (ex- 
tents) as it is required by the user. 


The logging buffer is divided into connunicaticn and buffer areas. The con- 
nunscation area is used to pass information ancng the users and the logging 
process. This infornation includes status of the logging process and logging 
file, space renaining in the logging file and error information inmpertant to 
users or the logging process. The buffer porticr cf the loes:ng data segrert 
blocks inputs into the logging file before the data is actua'ly posted. The 
buffer is flushed any tine a user requests to close a log file or wien a iog- 
ging process is terninated. (The buffer is also flushed by the begin/end 
transaction or buffer flush requests). 
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Tiner Request List (TR ont. 


CODE & REQ indicate the type of request. 


CODE: REQ: TYPE: 
0 OITP Kangup 
{ OITP Carrier failure 
2 DITP 202 turnaround 
3 DITP Read 
4 DITP Logon 
5 PC8B index Delay 
to process 
6 OITP LP not ready 
? DITP 2640 
x10 Port nask fisg port tinecut 
Z11 DITP Block node read 
timeout (30 secs) 
212 PCBB index Watchdog tiner for 
to process process 
Z13 Port OST Port Procedure Tineout 


The list of pending requests is kept ordered by tine with later 
entries at the tail. 

120-237 OITP SIO device tinecut: 
DIT8. (code_1 on 
expiration, cleared 
on Tinereq. 


For Series 30/33, OTINE is 
# of TICS (0.091457 ns) 
since last midnight. 


25/26 *OTINE 
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rror Recove escription 


The error recovery nechanisns provided by User Logging are pouer fail 
recovery and recovery fron systen failure. 


Power failure recovery applies only to tape log files since APE provides 
adequate recovery for disc files during poner fail. When a power failure is 
detected, a message will be printed cn the console asking the operator to 
place the tape drive back on-line. (If the operator places the tape on-line 
before the message valid data nay be overwritten). (To reset the tape drive 
the operator must hit the load button until the tension retums to the drive. 
Then hit the reset button followed by placing the tape drive back on-line. ) 
At this tine the log process will recover the file by rewinding to the load 
point and then foruard spacing to the point where the pouer fail occurred. 
Writing to the log file will continue at that point. 


In the event of a systen failure, the warn start load ception initiates 
recovery of User Logging files. In the case of a serial file, the file is 
read and conpared to the disc logging buffer. All records found in the disc 
buffer that are not on the serial log file are posted and a proper end-of- 
file uritten. If the destination file is a disc file, all records are read 
and verified and an end-of-file posted to the file. In order to continue 
logging to a User Logging file that has been recovered in this manner, the 
1ogging process for the file must be restarted using the console connand 


NOTE: omy recone in the buffer area of the logging buffer will 
e lost. 


User logging has been enhanced to work with labeled serial 
discs. Internally the log precess handles serial disc serial 
disc (or cartridge tape) log files the sane as for tape files. 
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Design Structures FREE - A table relative pointer to the first free entry 
in the legging table. (-1 2 Table Full.) 
User Loqaang Table 
INUSE - fi table relative pointer to the first entry in the 
| EWTRY SIZE = 244 uords the logging table that as being used. (-1 = No Entries 
OST 233 in Use} 
Table containing an entry for each activated user logging process. Each BUFNUN - The nunber of the buffer associated with this logging 
entry is created when the process 18 started, and deleted when the process process. Used to create the nane of the buffer file 
terninates (via :LOG connand). The information is extracted fron the Logging if serial log fale (1.@., ULOGuxxx.PUB.SYS). 
Identifaer Table (LIDTA8). 
MAXLOGPROC - The naxinun nunber of user logging processes alloued. 
ntry 0 MAX°USR’PROC - The naxinun nunber of users per logging process. 
# 
eoeonnnonccooncoceree | LOCTAB’ESIZE - The size (in uords) of each entry in the table. 
O| NUMBER OF ENTRIES 0 
1] FREE ENTRY HERD PT. |1 Typical En 
2| INUSE ENTRY HERO PT. {2 ; | 
i NEXT BUFFER NUMBER |3 : 
ys MAX # PROCESSES |4 LOGGING | 
MAX W USERS/PROCESS |5 IDENTIFIER | 
6| {6 | | 
|---------- onnnneen---| |---nene-nnnn-nenonenne | 
7| ENTRY SIZE ‘i st ‘i 
| ai . ‘y BUFFER | 
4s| 137 | NANE | 
|n-sconecernvennnnnne=| I- -| 
| | 
WORD ENTRIES | 4 
NUNENTRIES = —_LOGTRB | PILE | 
FREE = LOGTAB(1) \- -| 
INUSE = LOGTAB(2) | WANE | 
BUFNUA = LOGTAB(3) |- : 
RAXLOGPROC = LOGTAB(4) | 
MAX’USR’PROC == —s LOGTAB(S) | ------ wececcnccconnee | 
LOGTAB’ESIZE =  LOGTAB(7) 
NUNENTRIES - The nunber of entries in the legging table. 
G.23.00 6.23.00 
17- 23 | 17- 24 
Hiscellanecus Hiscellanecus 
T A fn TABINDEX s WORD INDEX TO CURRENT ENTRY 
BTABINDEX s BYTE INDEX TO CURRENT ENTRY 
sal? \2 DTABINDEX s DOUBLE INDEX TO CURRENT ENTRY 
|- =| LGNANE s BTRBINDEX 
| vocK | BNANE s BTRBINDEX+8 
l\- -| LFNANE s BTROINDEX16 
| WORD | UFLOCKU 2 BYABINDEX+24 
l- -| LFGROUP s BTRBINDEX#32 
| LFACCT 2 BTRBINDEK+40 
| 20| {16 NURUSERS s TABINDEX+24 
|- -| DST s TABINDEK+25 
| GROUP | STATUS s TABINDEX+26 
I- - LGRUTO 2 TRBINDEX+27. (0:8) 
| LGTYPE s TRBINDEX#27. (8:8) 
|- =| LGDEV ® TABINDEX+28 
| | PIN s TABINOEX+29 
| onnwcccencnccnenereen| LOSWITCH s TRBINDEX+30 
| 24| }20 LGNEWRUTO s TABINDEK+31. (0:8) 
l- -| LGNEUTYPE s TRBINDEX+31. (8:8) 
| ACCT | LGRDOR z DIRBINDEX+16 
I- -| BSizE s OTABINDEX+17 
| | NEXT = TABINDEX+36 
|- -| PREV s TRBINDEX+37 
| | 
| 30| NUMBER OF USERS 26 LGNRANE - The nane of the logging precess (logging identifier). 
| 31| BUFFER OST NO j25 BNANE - The nane of the disc buffer used if the logging process 
| coco ccecncncee woocen| destination file is a serial file. This is a file that resides 
| 32] LOG STATUS \26 in PUB.SYS. The format of the nane is ULOGxxxx where xaxx is 
j a Poo | the buffer nunber padded on the left uith zeros. 
| 33)/CURR RUTO | CURR TYPE|27 
{ aa enn If the switch flag is true, the following will be the fully qualified 
| Ml LOG DEV \28 file nane of the new log file. 
| 35] L6G PCa e |29 LENANE - The nane of the logging file. 
| SUITCH his 130 UFLccaw ==: The lockword of the dise logging file. 
| 37| NEW RUTO | NEW TYPE 31 LFGROUP - The group that the destination logging file resides in 
i ees Pend | 1 the file 18 a disc file. 
| 40| RDORESS OF 132 
| LOGGING BUFFER | 
i 42] SIZE OF 14 
| LOGGING BUFFER | 
| 44| FORUARD ENTRY PT (36 
| es BACKWARD ENTRY PT {137 
6.23.00 
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LFACCT 


NUAUSERS 
OST 


STATUS 


LGRUTO 


LGTYPE 


LGDEV 


PIN 
LGSWITCH 


LGNEWARUTO 


LONEWTYPE 


LGADOR 


BSIZE 


NEXT 


PREV 


Miscellaneous 
The account that the destination logging file resides in 
if the file is a dase file. 
The nunber of users currently accessing the logging file. 


The DST nunber of the logging data segnent (LOGBUFF). 
(-1 = LOGBUFF not created yet.) 


The status of the logging process. 
INITIALIZING 2 -1 


INACT = 0 
ACT z 1 
RECOVERING = 2 


True if the automatic changelog facility was enabled. 
(Not used - for future use.) 


The Meee destination file of the logging process. 
3 
TAPE 31 
SOISC = 2 
CTAPE = 3 


The logical device nunber of the disc logging file or the 
disc logging buffer. 


The PCB nunber for the logging process (PIN * PCBSIZE). 


Flag indicating a CHANGELOG is pending (if true). 
(Not used - for future use. ) 


True if the autonatic changelog facility uas 
requested for the new log File. (Not used - for future use.) 


If a euitch is pending, this will be the type 
of the new log process. (-1 = no switch pending. ) 
(Not used ~ for future use.) 


Sector nunber of the current extent in the disc logging file or 
the disc buffer file. (Disc buffer file has only 1 extent) 


The nunber of records in the current extent (for dise legging) 
or the nunber available in the disc logging buffer. 


A table relative pointer to the next entry in the logging 
table. (-1 = this is last entry.) 


A table relative pointer to the previous entry in the logging 
table. (-1 # this is first entry) 
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Connunications Area 


0} 10 
| LOSGING : 
|” sDENTEETER | 
a 

4] SUITCH FURG \4 


=| 
5| CHANGE | NEW TYPE [5 


2eeeeeeeee | cwreeneeare 


6] AUTO 86©| TYPE [6 


7| BUFFER DST |? 


28224080828 28086088880860 j 


10} LOG PIN 18 


11] NUMBER OF USERS {9 


80 O2S2 O20 OSC S CES SESTOSESE 


12| MAX NUNBER OF USERS|10 


13] NEXT USER NUNBER {11 


14] SLEEP COUNT |12 
sme 13 
ie aaa 4 
vl ue NS 
eee 6 
Niet 7 
eal ioe OEvICE lis 
sl ae ee as 


| 
25| FILE SET NUNGER = at 


261 LOG \22 
| ADDRESS | 
| INT 124 
I econo | 
[ese eeeees| 
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User Loqqing Buffer 


There will be one of these tables around for the life of any active user log- 


ging process. The table consists of three parts: 


COMMUNICATIONS RARER - Information about status of the process, etc. 
that 18 connon to all users of the process. 
Alse the cells for nessages to/fron the 
process. 


USER ENTRIES - Information for a specific user of the process. 


One of these for every user of a process 
(Setup by OPENLOG, released by CLOSELOG). 


BUFFER AREA - Buffer used to hold logging records fron 
all users before writing to the log file. 


|-- COMMUNICATIONS AREA --| 
| [oo 
| ENTRY w2 bad add 
| ENTRY #3 renee 
| ENTRY 44 falas 
| poecw nme m nw cwonenwe wenn nn nena necnesocewseccores | soe | enn 
| | 
| . | 
| . | 
| . | 
Rs ee ai a a ea | 

ENTRY #N Halled 


| 

| 

| | 
| [ 
| | 
| | 
| 4K WORDS | 
| | 
| | 
| | 
| | 
| | 
| | 


O88 OS COS 609 O8 8 OOOO SOE2SO8 SSS S888 SESE 8ESESE CSS OSODBFABDOTOE®D 
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n ns A fn 
| ---------—---- nn nmn| | -----------—---=-=- 
| 32| FILE e 56) OLD’ NUN’ EXTENT is 
| SIZE | §7| 147 
| * FILE ad 60| IN USE HEAD PTR 148 
| SPACE 61| FREED HERD PTR (49 
| | TOTAL a 62| FIRST FILE | 
| RECORDS | | CREATION TIME | 
| ga MAX fi 64| FIRST CREATION DATE|S2 
| | SIZe | 65| FF TYPE 153 
1 42] LAST EXTENT \" 66] P° TYPE [54 
| a EXTENT fag 67] CTYPE {55 
| “| 136 70| N° TYPE 56 
[- -| oocnnnennnnene nanan | 
| | 
\- RESOURCE! - 
\- -| 
| | 
[----enmnenneennnn--———| 
{ i tag 
| RESOURCE2 
| 
- -| 
| | 
| S54] OUD LIAIT i“ 
| | 
|-----------n---------| 
G. 23 e 0 
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Riscellanecus 
Connunjcations Area (Cont. ) 
J ococeecosenon= eeeree= ic. » gig lPRRterseneaseeceness 
| 69] FIRST \57 201] 1129 
|- FILE -| l- - 
| — ! 
| | | 206] REC’S IN 1134 
I = - ° 
] | PREVIOUS FILE | 
| sh i RARER RS ee roree ewe se 
| | 210| F.S. ERROR 1136 
| 211] U.L. ERROR )137 
| te HERD PIN 1138 
| 87] PREVIOUS {75 213] }139 
J- FILE “| _ ew eeeececceeceecenee | 
| ! ! | RESOURCE3 = 
| - % 
l | | | 
|- -| [- -| 
| | [ | 
1 | \- -| 
| { [esteeteeeersecaaeses | 
l- -| 
: ! 
| 135] CURRENT 193 
|- FILE -| 
| | 
|- =| 
| | 
l- -| 
! : 
| 157] NEXT FILE ah 
\- . 
| | 
\- -| 
| | 
\- -| 
| | 
|-ceonnneee onnon-nnee-| 
6.23.00 
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FSERR’ CODE s LOGEUFF (136) 
ULERR’ CODE s LOGBUFF (137) 
HERD’ CKANGE’PIN = LOGBUFF (138) 
RESOURCES s LOGBUFF (140) 
NOT’ SAFE'TO’STOP = LOGEUFF (144) 
LOGID - The nane of the logging process. 
SWITCH? - True if log file suitch is in progress. 
CHANGE - True if log file nane, such that changelog is alloued 
(i.e., first fale in the set nane filenane 001). 
NEUTYPE - If a suitch was requested, this will be the type of the new 
losging file. (+1 = no switch pending) 
(Not used - for future use.) 
RUTO - True if the autonatic changelog option uas specified for the 
current log file. 
LOGTYPE - The vee of 7 ileal file for the logging process. 
ist # 
TAPE 2 1 
SOISC = 2 
CTAPE 2 3 
BDST - The deta segrent nunber of this table. 
LOGPIN ~ This is the FCB nunber for the logging process (PIN*PCBSIZE). 
NURUSER - The nunber of users currertly accessing the logging file. 
MAXUSER® - The maxinun nunber of users allowed to access the logging file. 
USERNO - The next sequential number to be assigned users accessing the 
systen. It wali get increnented for every unique OFENLO 
and 18 used as the log # in the logging record format. 
SLPCT - The nunber of users currently waiting for activation by the 
losaing process. 
STATE - The state of the user logging process. 
thPCTIVE = 0 
ACTIVE 31 
SG - fin internal nessage word -sed to indicate an error or 


a 


operator request. 
6 - Continue processing, all is fine. 
2 ~ Suspend - error reacing tuffer file or uriting 
to serial file 
3 - Stop - set wher issue :LOG logid, STOP cr uhen an COF 


Condition is found on the disc 23 fale. 
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Hiscelleneous 
LOGHSS - 
USERNSG - 
LOGERR - 
LOSDEV - 
OSPRCE - 
BUFUSED - 
VSETNO - 
LOGRDOR - 
INBUFREC + 
FSIZE - 





LOGID 2 BLOGBUFF (0) 
SWITCH’ 2 LOGBUFF (4) 
RCKANGE z LOGBUFF (5). (0:8) 
NEUTYPE 3 LOGBUFF(S). (8:8) 
AUTO s LOGBUFF (6). (0:8) 
LOGTYPE 2 LOGBUFF (6). (8:8) 
BOST z LOGBUFF (7) 
LOGPIN 2 LOGBUFF (8) 
NURUSER 2 LOGBUFF (9) 
MAXUSER’ 3 LOGBUFF (10) 
USERNO z LOGBUFF (11) 
SLPCT = LOGBUFF (12) 
STATE z LOGBUFF (13) 
nSG 2 LOGBUFF (14) 
LOGASG 2 LOGBUFF (15) 
USERMSG z “ LOGBUFF (16) 
LOGERR 2 LOGBUFF (17) 
LOGDEV 2 LOGBUFF (18) 
BSPACE 3 LOGBUFF (19) 
BUFUSED = LOGBUFF (20) 
VSETNO 3 LOGBUFF (21) 
LOGRDOR s DLOGBUFF (11) 
INBUFREC 3 DLOGBUFF (12) 
FSIZE 2 DLOGBUFF (13) 
FSPACE’ s DLOGBUFF (14) 
TRECS 2 DLOGBUFF (15) 
NAXF SPACE z OLOGBUFF (16) 
LASTEXT’ 8 LOGBUFF (34) 
EXTENT 2 LOGBUFF (35) 
RESOURCE 3 LOGBUFF (36) 
RESOURCE2 s LOGBUFF (40) 
UHERD 2 LOGBUFF (48) 
FHEAD 2 LOGBUFF (49) 
FIRST'C’ TINE s OLOGBUFF (50) 
FIRST’C*ORTE s LOGBUFF(S2) 
F° TYPE s LOGBUFF (53) 
P* TYPE s LOGBUFF (54) 
C’ TYPE s LOGBUFF (55) 

8s 


N’ TYPE LOGBUFF (56) 
FIRST’ FILE 
PREVIOUS’ FILE 
CURRENT’ FILE 
NEXT’ FILE 


RECSIN’ PREV 


BLOGBUFF (S57) 
BLOCBUFF (75) 
BLOGBUFF (93) 
BLOGBUFF (111) 


DLOGBUFF (67) 
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6 - Continue processing, all is fine. 
1§ - EGF - if there are no nore extents available 
to be allocated. 
12 - Dise space - could not allecate the new extent 
because no space left in the group. 
9 - Urite error - error occurred while uriting to 
leg file. 


A messages fron the user process. 
6 - Continue processing, all is fine. 
12 - Dise space - user process needs another extent 
allocated for disc logging. 


True if error condition during changelog. 


The logical device nunber of the current extent 
of the disc file file or the disc buffer file 
(buffer file has only 1 extent). 


The anount of space, in records, that are currently 
available to the users. On the last block of the last 
extent, one record will be saved by the logging process 
go that the proper close information can be posted to the 
file - either the trailer record (if the log logging 
procees ie stcpped) or the change’to'new record because 
of an EOF condition ;(and the RUTO opticn had been 
specified). 


The nunter of records currently in the buffer. On all extents, 
except the last extent BUFSPRCE+BUFUSED = 32 (nunber of records 
in a complete block). However, on the last block of the last 
extent this will NOT be true since one record is aluays held in 
reserve by the logging process. 


This shows the order in the log file “set” of the currently 
opened log file. 


The dise address of the current extent of the disc log file. 
If it's a serial file, this is the disc address of the 
disc buffer for the file. (Current file.) 


The record nunber of the next block to be uritten to the 
hogging destination file or the dise logging buffer for serial 
files. (Used as an offset into the current extent for the 
writes - since each record is cne sector in length). 

(Current file.) 


A nessages fron the logging process. 





The current extent size of the logging destination file or disc 
logging buffer file for serial destination files. 
(on the last extent this will be the last extent size ninus 1). 











fluscellanecus 


FSPACE’ - The space in records that renains in the current extent of the 
disc logging destination file or disc buffer for tape 
destination files. (On the last extent of the disc log 
file, this 18 the anount of space manus 1). 


TRECS - The total nunber of records uritten to the logging destination 
file (including those records currently in the buffer). 
(Total records written to all log files in the set.) 


AXFSPACE - The total file size, in records, minus 1. (Need that last 
record to post close information.) (Current file.) 


LASTEXT’ - The extent nunber of the final extent in the disc logging 
file or disc buffer file. 


EXTENT - The current extent nunber of the dise logging file or 
disc loggang buffer. 


RESOURCE - Used for resource nanagenent (i.e., locking the buffer area 
and buffer information in the connunications area). 
Fornat 18: 
RESOURCE + O = Owner PCB nunber 
RESOURCE + 1 = Head of impeded queue PCS nunber 
RESOURCE # 2 = Taal of impeded queue PCB nunbder 
RESOURCE * 3 = Queue Length 


RESOURCE2 - Use for locking file infornation and nessages in the 
communications area. 


OLD’LIMNIT - The nunber of records in the last disc log file. 
OLD’ NUN“EXTENT-The nunber of extents in the last disc log file. 


UHERD - A table relative pointer to the first entry into the logging 
data segnent. (-1 2 no entries currently in use) 


FRERD - fi table relative pointer to the first free entry in the logging 
data segnent. (-1 = no free entries) 


FIRST’C’ TINE-First file creation tine. 
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Typical Logbuff Entry 
| -ennnerenenneennnnnn=} 
0| |o 
{- -| 
ee 
| WANE j 
l- -| 
| | 
|-eor- woccocececcone== | 
4| \4 
\- -| 
GROUP | 
| NAKE | 
l- -| 
| | 
| -----------e none nee ee| 
| 10] |3 
|- -| 
| | 
I ACCOUNT | 
|- NAME -| 
| 
| " USER PCB # ue 
| 15] OPENLOG COUNT {13 
| ie WAIT STATE \14 
| 17| ERROR CODE \15 
| a LOG NUMBER 116 
| 21} SUBSYSTEN CODE \17 
| 22| TOTAL 118 
| RECORDS | 
| oon n oon eneen= woccenee| 
| | 
|- =| 
| | 
|- -| 
| : 
| 27] FRUD ENTRY PTR fi 


fisceilanecus 


FIRST'C’DATE-Firest file creation date. 

F* TYPE - First log file type. 

P* TYPE - Previous log file type. 

C’ TYPE - Current log file type. 

N' TYPE - Wext log file type. 

FIRST'’FILE - First log file in the log sequence. 
PREVIOUS’ F1.£-Prevacus log file in the log sequence. 
CURRENT’FILE -Current log file in the log sequence. 
NEXT’FILE - Next log file in the log sequence. 


RECS’ IN’PREV- Total runber of records in all of the previous file in 
the log file set. 


FSERR’CODE - Fale systen error encountered upon changelog. 
ULERR’CODE - User logging error encountered upon changelog. 


HERD’ CHANGE’ PIN-PCB index of process waiting for :CHANGELOG connand to 
flush. Note only one process waiting at a tine. 


RESOURCE3 - Use for locking user entry area and pointer information 
about the user entries in the connunications erea. 


NOT’SRFE’TO’STOP-If it is set, then do not process the Stoplog until 
exchangelog resets the bit. 
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BINDEX = BYTE INDEX TO CURRENT ENTRY 


INDEX =z WORD INDEX TO CURRENT ENTRY 
DINDEX 3  POUBLE INDEX TO CURRENT ENTRY 
USER =z BINDEX 
GROUP =  BINDEX+8 
ACCT s  BINDEX+16 
UPIN = INDEX+12 
OPENCNT = INDEX+13 
WSTATE x INDEX+14 
ERROR = INCEY +15 
LGNUA z INDEX+16 
SCODE = INDEX+17 
RECS = DINDEX+9 
NENTRY =  INDEX*23 
PENTRY a = INSEK+24 
USER - The nane of the user uho opened the logging file 
through this entry. 
GROUP - The group of the user who opened the logging file. 
ACCT - The account of the user uho opened the logsing file. 
UPIN - The PCB nunber of the user process (PIN * PCBSIZE). 
OPENCNT - Counter of how nany tines this user called OPENLOG. 
(Increnented for every OPENLOG, decrenented for every 
CLOSELOG). 
USTATE - The uait status of the users process. 
INACTIVE #0 
ACTIVE #1 
ERROR - Used to hold error information for this user. 
-1 = No roon in dise (or disc buffer) acd KOUATT. 
0 = OK. 
LGNUA - The !seging nunber assigned to the user. (fron USERNO in 


global area to be used as log # 1n the !og record). 


SCODE - The sutsysten code for the caller. This applies only to 
privileced callers. 


RECS - The nunber of reccrds written by t*18 user. 


NENTRY - A table relstive pointer to the next er.try in the 
logging data seguent. (-1 = this ig che last entry) 


PENTRY - § taLie relative posnter to the previous entry in the 
logs'7g data sestent. (-1 = thas as che first entr;) 
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User in ntifier Tab 


| ENTRY SIZE = 241 uords 
DST 241 


Table containing an entry for each potential logging process. Entries are 
added via :GETLOG and released via :RELLOG. 


Entry 
] z 
| eoccenrerensoccenceen | 
°| 10 
1{MAX KUMBER OF ENTRIES|1 
2] l2 
3 13 
4| ENTRY SIZE \¢ 
| . | 
| . | 
| 40] . }32 
|onnnennnneeeennnnnne= | 
ENTRIES 
MENTRIES s LIOTAB(1) 
ENTRYSIZE 2 LIOTAB(4) 
NENTRIES - The naxinun number of entries in the table 


(i.e., naxinun nunber of user logging processes; 
1 entry for every process - activated or not). 


ENTRYSIZE - The size of each entry in the table. 
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T al _En n 
|-------------------==| 
| | \™ 
USER’S 
| WARE | 
|- -| 
| | 
|---------== onnno---e| 
l | \28 
! USER’S | 
| ACCOUNT | 
|- -| 
| | 
| ‘0 LOG TYPE 132 
BYTE ENTRIES 
LID s  BLIOTAB 
Pu =  BLIDTRE(8) 
FNAME? = = 8LI0inB(16) 
Ud 2 BLIDTAB(24) 
FGROUP) == )~— BLIP TAB(32) 
FRCCT 2 BLIDTAB(40) 
UNANE z B@LIDTAB(48) 
uacct s  SLIDTRB(56) 
WORD ENTRIES 
TYP =  LIDTRB(32) 
LID - The logging identifier nane. This is a maxinun of eight 
characters long. 
Pu - The pass word for the logging identifier. This ie a 


naxinun of eaght characters long. 
The follcuing is the fully qualified file nane of the current log file: 
FNRNE’ - The rane of the destination file. 
Ww - Tre leckuord on the destination file if the file is on disc. 
FCROUP - The group that the file resides in. 
FACCT - The account that the cestination file resides in. 
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Mascellanecus 
Typical Entry 
|-nnennennnnenennenens | 
‘| 0 
LOGGING ! 
IDENTIFIER ! 
I | 
|----2--2nnonwennonnn= | 
4| 14 
} 1 
I PASSWORD . 
l- -| 
| | 
|--------n-0nnnnnnna ne | 
| to * 
! FILE | 
| WARE | 
I- =| 
| | 
 Kecetetetatetaetatetatatatatenetetetenatatal | 
| "41 itz 
| FILE | 
| LOCKUORD | 
l- -| 
| | 
|--neennonnnennnnn ----| 
| 201 In6 
FILE 
| GROUP | 
I- =| 
| | 
|[-onanennnncennennn--= | 
| 2a \20 
| FILE 
| ACCOUNT | 
\- -| 
| | 
|------nnnon--nn------| 
6.23.00 
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UNAIE - The nane of the user who created the logging identifier. 
URCCT - The account of the user who created the logging identifier. 


TYP - The etatus of the entry. 
(0:1) = Auto changelog allowed 
(1:1) # No Auto on :GETLOG, :ALTLOG 
(2:7) = Previous type 
(9:7) = New type 
0 = Dise log file 
1 3 Tape log file 
2 = Serial disc log file 
3 2 Cartridge tape log file 


Loaging Record Fornat 


RECORD SIZE = 128 uords 
USER AREA = 119 words 


LOG RECORD AT CPENLOG 
0 2 3 4 6 7 1 (12 244 25 127 


| a | 4 | | ! 
RECHICKSUMICODE |TINEJOATE| LOGIO|LOGe|  CREATORIPCB | | 


USER OR SUBSYSTEN/CONTINUATION LOG RECORD (fron URITELGG) 
0 2 3 4 6 7 8 9 127 


| yf ft ! 
RECMICKSUNICODE | TINE |OATE| LOCH) LEN| USER RREA | 


28868 f 22OGe@ | CSOOS@ j COO }| Cee | cere | eee | SOS SSOSC ST CZCS DOST4ASFEE8°0 | 


LOG RECORD AT CLOSELOG 





0 2 3 4 6 7 WW 42 . or +-] 127 
[oncne|onna=|oonn= once |orne|-nnea= [onan |anneecscce| oor e[enncene| 
fof ft tof py 1 | 
| RECMICKSUN|CODE |TIME[DATE| LOGIDILOGH}  CREATORIPCB | | 
wnnna|acome |annne]oen=|onne |onnnne | nnn denne conned eee |eeeeee | 

CRASH FRRKER 
0 2 ? 127 
|--now | enon | --nn= | onan [nnn | onn--eaneennnenan-ssneeeceecnnnnnne 
ae | 
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Miscellaneous Miscellaneous 
RECWICKSUM|CODE {TINE (DATE! I | | | on eee eee / 
|! oe od | ooeee J onon | coon | enenno rower nnn no nennoncoerorennee | ae (dao based fag ec i . 
RO (START/RESTART 
HEIDEN RECORD: COURT CHANGELOG RECORD (Cent. ) 
a 6 ? 11 127 
ial Sent one-- J-o--]----|------- | enone nn nnennnnnn-e nnn -e- == | 11 ‘ . ae = a se | ae ne 
; | ot | | |ncnnee[ecceas |occens |oseenn|enenne|eccene| oncene |onaeee | onnena|aee 
WICKSURICODE |TIME|DATE| LOGIO \ | | | | | | | | | 
ee a Hee eoee | con eene wecccewenncccww ene enceeen ee / seed Eel Mall AS A te as pp 
TRAILER RECORD (STOP) Note: If CODE 2 12, P-File = Previcus file in set. 
If CODE = 13, P-FILE = Next file in set. 
0 2 3 6 ? 11 127 
| ----- | -----|----- | cocecee eeceeeennwnecnwe re wecnooece | CODE DEFINITION 
| | | j | 
| RECWICKSUN|CODE |TIME|DATE! LOGIO | \ CODE.(8:8) 
Jenna e |--nn= [enna a [enn n Jonmnn | one nnen | monn n nnn nn nnn nnn e nee n eee nn= | 1 Open log record 
User/subsysten record (URITELOG) 
NULL RECORD 3. Close log record 
4 Header record 
0 2 3 4 6 7 12? § Traaler record 
|----- |----- |----- | poce | cone | eon n ena nn ne en en nn nn nnn nn ene nnecen- | 6 Restart record 
| | | | 7 Continuation of a user or subsysten record 
| RECHICKSUM{CODE |TINE|DATE| | 9 Crash marker 
wonne | coeee eS bod one) Ce at heii | 10 End transaction record 
11 Begin transaction record 
12 Changelog record in new file 
13. Changelog record in old file 
BEGIN TRANSACTION MARKER SPACE NULL record 
0 2 3 4 6 ? 8 9§ 127 
|anne= | ances | --na=| ence | -nn= | --o= | n= | onenwnnenennnenennenn omnes | 
| { | ie! sere eee ae: | 
| RECWICKSUMICODE | TIME |CATE| LOGH| LEN| USER RREA | 
[-2==- [eass= [se==* | cone [once [noes [one | ann enn meee norenennenecccen | 
END TRANSACTION MARKER 
0 2 3 6 ? 127 
[asec] <4"=< Jeers ee ae ie Sserdsnnastesceeseeeeses= | 
| RECW|CKSUN|COOE ile bee sh eel USER AREA | 
CHANGELOG RECORD 
3 4 8 
|--na=|an--= | ----= |---| ===] === |--enneneennann-nnnennnnnnnnnnne | 
6.23.00 6.23.0 
17- 43 17- 
Niscellaneous Neasurenent Infornation Table 
DATA FIELDS CF LOG RECORDS MERSINFOTAB 
OST = £73 (59) 
RECS s DOUBLE INTEGER 
CKSUn s INTEGER 
COOE 8 INTEGER colece [enn en ene nwo new cwewnonncconcwnnwonces 
TIRE s DOUBLE (fron intrinsic CLOCK) | Of UDEV @ OF REASIO {MEASLDEV 
DATE = INTEGER (fron intrinsic CALENOAR) | | ----------- erceeeeecorece weeerencsces | 
LOGIO s ASCII | 1] MEASTO PLRBEL |MERSPLAB 
LOGH 2 INTEGER | Poo ereoewenn-es- 
LEN s INTEGER | 2{ MEASIO OST & |MEASDSTN 
USERRRER 2 ASCII ; [| [owen newer wen eowncewwnewcercnce eeecoene 
CREATOR s ASCII Reserved 3] | 
PCB 8 INTEGER for MEASIO | eoewereweenwenwnnnennceoncoccconcoce= | 
C-OATE s INTEGER control 4| | 
C-TINE 2 OQUBLE | | coecewcoeneoeeceen wowwccce waccccccen=| 
F-FILE-NANE = ASCIT | 5] | 
P-FILE-KANE 8 ascir | | enone n nnn ween e nn ne cer ecnee soeee------| 
C-FILE-NANE = ASCII | 6| | 
F-TYPE s INTEGER | | pore mew wnn www wm wenneeowweecnsncccee | 
P-TYPE s INTEGER | 7| | 
C-TYPE s INTEGER co fee  [ecennneweenneeeee aa teeta | 
SEQ a INTEGER a 
1 ii | 
NOTE: | [eeeeeeeeeenenennnnnennncnnnenscnennnn| 
i 12| ! 
1. The checksun algorithn uses the exclusive or (X0OR) function against a base Reserved | ene n manne nn wewesne een coseenencncccenn| 
of negative one. for 13| | 
performance J renen nn eeeneee nonsense nesnecececncee | 
2. Null record is used for filler. tuning 14| | 
paraneters | ~e non none nn nn enw mewn enone nnennnenee| 
3. The code word of the logging record can contain a subsysten cede derined } 15} | 
by the user in the firet half of the word (0:8). User logging allows | | pew nn cee ewww enn ecw nen coeece woocen | 
privileged users to pass this code in the index paraneter of the OPENL°C | 164 { 
intrinsic. | ‘a1 wo ence wn ew nnn nnen cee cococecconooecce | 
4. The “len field will contain the entire length of the data in the transac- walne | cece een n nn nnn n nn connec wen eoecceneee - 
tion (i.e., the length passed to UWRITELOG, BEGINLOG, ENDLOG). If a con- | 201 GLSBAL STATISTICS KOS NUNBER [NEASSTATX- 
tinuation record is part of the transaction, it will also contain the en- | |OSNU 
tire length of the data. For exanple, a length of 140 was passed to the | | enon cnn nen ene e wenn nnwccce woweccowene 
intrinsic. The “len” field of the first record will be 140, the “len” | 21] CLASS 1§ STATISTICS XDS BRNK |NEASPROC- 
field of its continuation record will also be 140 - even though the actual | | {XDSBANK 
ancunt of data found in the first record will be 119 and the data founa in | [peewee wen nwo enn nnccceecccscccccne | 
the continuation record will be 21. (Positive length = & words, negat.ve | 22) CLASS 15 STATISTICS KOS BASE |MEASPROC- 
length » # bytes) | XDSBASE 
| 23] CLASS 15 STATISTICS KOS NUMBER |MERSPROC- 
! | aoe 
| 24) CLASS 14 STATISTICS XOS BANK | 
25 CLASS 14 STATISTICS XOS BASE | 
6.23.00 6.23.00 
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Reasurenent Infornation Table 


fleasurenent Information Table 


| 57] CLASS 14 EN.CNT. 


2882 SOS 8282822 288820808 


o 
a” 
a” 
-—_- 
mn 
mm 
=z 
o 
xz 
=4 


NEASINFOTAB (Cont.) NEASINFOTAS (Cont. ) 

[westeowensoseesescceses ern lenssacns ss |. Jreeseemennssnecereesesewrwnsecnssncce | 
26| CLASS 14 STATISTICS mess: NUR. | reserved | ! 
a sm aN SAA i for Sseseeaeeersennee reer SKS rses ee R nese 
27| CLASS 13 STATISTICS KOS. BANK | neasurenent . | | 
| rornecnenenensewoncccescnencnnconscce | interface —_ | w-nowe re nmnernnennserenserserernrrene | 
CLASS 13 STATISTICS X0S BASE | . 
a CLASS 13 STATISTICS XOS NUN. | | 50| _ © ENABLED cauat 1 ENABLED | 
32| CLASS 12 STATISTICS XOS BANK [> - eeeseseeebatoasss | sacate sensed eeeeees 
ee ereccnenenneennennenncenen=| [ 51] CLASS 2 EN.CNT. | CLASS 3 EN.CNT. | 
33| CLASS 12 STATISTICS os BASE | ed Serene | enoccecnnnneneseen= | 
encecenecconenencernatenntanenee woos | S2l CLASS 4 EN.CNT. | CLASS 5 EN.CNT. | 
34| CLASS 12 STATISTICS X0S WUA. | eas Seana  fesenimncien stn eree 
|----eerennnnnnnennnennnrenvennwe enna | | 53] CLASS 6 EN.CNT. | CLASS 7 EN.CWT. | 
35| CLASS 11 STATISTICS xOS “BRAK | ne ee [ocdedececsecs sce | 
eonccccnnnncensenennceeneseenacenenee [ SG] CLASS 8 EN.CNT. | CLASS 9 EN.CNT. | 
36| CLASS 11 STATISTICS x0S- BASE | ee Ee | eoweennnnnnncornnne \ 
|--nawonnnennncenene en | S51 CuRSS 10 EN.CNT.| CLASS 11 EN.CHT | 

| | 

| 

| 

| 

















| woon | mew eenewwwceonccan | concen encvececencce 
42| CLASS 12 STATISTICS 2x0 OS MIN | 1S) rece areas ee 
431" CLASS 15 STATISTICS 20D 10S BOK | Bat PO id ce cate chat ae Be 
4a| CLASS 15 STATISTICS 2ND NOS BASE | Fa 5 cee me ee eee ! 
45|""Cuags 18 STATISTICS 200 108 WR, | tO Set acre Sek aca tae 
[aseeeseeensnseesoeasesseneracresecses | user 64] | 
£8 As of Release 23, all pin Ws > 629 for classes 12 end 15 will ears pee: are steers ! 
appear in the 2ND set of extra data segnents. | | penn nnn nnn nnn n-ne nomen enn e none nnene= | 
ie eee rete treme nee 
fae ie orate tenet ta 
6.23.00 6.23.00 
17 47 17 48 
Neasurenent Information Table Security OST Layout 
MEASINFOTAB (Cont.) 
Systen Glob ecurity DST 
=r ar FLRG ue ot DST # in SYSGLOB extension 230. 
sists a cam Z Table 1 
clock 72) MOS? | Bl ae esreengee oer aaa Oe 
mae ee Tucan 
Me 6n7 eae a\ cane Puan ERVeLON (ET) oI 
. i" eee | Riunun-passsend Met tas) 
Pavia | canna oF malty uncon niteapis Peete. | 
Lao o|"“sassunto PRONPT REQUIRED OPTION (ON/OFF) || 
| seol nonrtOR BUFFER DER CSMOMID | gt "Ube EaTURe Teammmarion oprien Coors) || 
| soil mens GER TSSCSCSCS*CUR SBF tol ghenie ibeew TIERCE GON fos CODE)” | 
| 1021 NERS BUFFER INDEX --"" penstOn Sok FOpte AINE LING OLY ot | 
reserved 103] RERS ENABLED FLAGS —~—~*UMERSNSNO | anf Dour Session TIME-OUT IW SECONDS = 
erent 1061” RERS ENABLED FLAGS ~~*UMERSNSKI i aa\cemiwemeWieonmaier 
1099179 cl "hens GUFFER BRK SSCS*CUMERSBUFBRINK bia eee eee 
Galo ee oa oe eae 
it oars | se ie pt ein ae) | 
} .] | 1 ‘6(WIC] | PUT |) Number of days to warn | 
A ere as 1 a \ adders eiasllend on jepe 1-1 
qe ire | lial ene cate | 
Se bee gee Gi Sei 
fs Interrupt ha nissed due to Lest interrupt handling | zl faurece ot aang 
A: Current interrupt handling active. 23) File maxinun prctertion on creation | 
| 
| | 


W 2 Warring Flag set in user entry 
C = SECUPTTYFROC *- clear the warn flag 
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Security OST Layout Security OST Layout 


Systen Global Security OST (Cont.) Connand Info Entry 


Table 2 


wo 
m 
- 


6 06 0000 8 0000S 28 OS OOO BHO SAHOO OOO IOS 














systen is brought up, this file usll be copied to a date 


segnent for faster access. The DACD is indexed by ldev nunber. 


| | 
1{ LOGON ATTERPTS COUNT - 1 WORD PER DEVICE {----\ P = Progrannatically execution disabled. (t:disabled, O=enabled) 
| INDEXED BY DEVICE NUMBER | | E = Execution of this connand disabled. (t=disabled, O=enabled) 
a | | | L = Logging enabled for this connand. (tzenabled, O=dasabled) 
| | | 
| porocoe nr ne nero n nen wnserosonrcrccwecowononen | | 
| EQUATE 
| SEC’ ENCRYPTION’ WORD 22, 
Table 3 | SEC’ PASS’ LEN’ WORD = 3, 
|oonnnenncnnnnnen ncn nn naceeeneeneee nen neenenne 1 SEC’ NUN’ ATTEMPTS’ WORD 24, 
0} COMMAND TABLE LENGTH (n) |<---/ SEC’ REQUIRED’ PROMPT’ WORD s S, 
| eenccecencncocnrannnenaecnernneneannncnnncsne | SEC’UDC' TERMINATION'WORD = 6, 
1] COMMAND @ 1 INFO |----\ SEC’ GENERIC’ MSG’ UORD = 7, 
| ecencennnnnnnencnnennenenncnenenennneoeennnn= 1 | SEC’ FOPEN’ LOGGING’ WORD = 8, 
2|  CONNAND # 2 INFO , 4 | SEC’SESSION’ TIMEOUT’ WORD 2 9, 
| onecewenennnnnnnnnnnennnenernnn mene nnwnnn ens a | SEC’ COUN’ TINECUT’ NORD =10, 
tof | SEC’ PROG’ WARN’ WORD 311, 
| | | | SEC’PW’ AGING’ WORD 212, 
[noeccwnnnnnennnnnenncennnnecnes crac neeeenenns | | SEC’ EXP’ DATE’ WORD 213, 
n| COMMAND # n INFO ; | | SEC’WARN’ ORY’ WORD 214, 
[-necncncnnn-n-nnnncnnnnnnnnennnnennnnnnennees | | SEC’ JOB’ ENBED’ Pu’ WORD 215, 
| | SEC’ CROSS’ STREAM’ WORD 216, 
| } SEC’STREAN’ PRIV’ WORD 217, 
Table 4 | | SEC’ INSURE’ LOG’ WORD 218, 
[encaccnenenrncenennnenncernenernnsennenenene= 1 | | SEC’ MAX’ PROTECT’ WORD £19; 
O| LENGTH OF TABLE 4 - DEVICE PASSWORDS | <---/ 
| eoncowen ee ennwennnn ewer ensenasonsece soscncene EQUATE 
1| LOGICAL DEVICE KUNBER j----\ GLOBAL’ OPTION’ TRB s |, 
| oon anew nnnnnnnnnnencnen nner anececceesee wne---| | ATTENPT’ COUNT’ TAB 22, 
2|  BASSUORO FOR LOGON PASS. PROMPT (8 CHARS) | COMMAND’ INFO’ TRB 3, 
31 DEVICE’ PASSWORD’ TAB = 4; 
5| | | EQUATE 
|eooeennnena= woeeeenceree weenneennnecececences| | | TABI’ LEN = 25, 
| , | | | TAB2’ LEN ® 1025, 
| ; | | | TABS’ LEN 2400; 
‘ |<<TAB4’ LEN is variable>> 
LOGICAL DEVICE NUABER ! ! 
| PASSWORD FOR LOGON (8 characters) i | 
| - 
| © (ENO OF SECURITY DST) fae 
6.23.00 6.23.00 
17- 51 17- §2 
DACD OST layout Job Security Naster Table 
rity T - OR ice Rece t finition TT TZ 
| 012345 6 7 8 91011 12 13 1415 ] DST = 61 = 275 
| Pe ed feees ed esa ond bed Fad Cored ed Ded Ctl Gated fd ed | | SIR = 15 = X17 (JNAT SIR IS USED) 
emma FILE LABEL (if ORCODST.PUB. SYS) | 
| / | TABLE SIZE(uords) | | 345 6 7 8 910 11 12 13 14 15 
| [ |nnenenennnnnnnn nner nnnnnrenneneoennnnnneenecene| | Feed eed feted Saeed Gerla Gl Cte Ge edad feed Deel eel 
|NEROER__{ DST NUMBER ! ! x0 flaxinun size | current size | (entry 0) 
| ‘ | NUMBER OF ENTRIES | 1 | entry size (246 words) | 
\l UNUSED 2 | offeet to first entry (246) 
| /\ VTAB INDEX { KOOR { | ‘ : 
| mocen nnn n nn con nnnn connec en nn nn renwrnrnenscsorne | - Reserved g 
| / LooR | | . ; 
JUDEV 1. f- | [eneseesentenean-senbeaenererons erro rrr eer | )} 451 | 
| \ | PSEUDO EXTENT SIZE(sectors) | | | penn wen nnn cn emenoene nen onenworosonenonnnecocooe 
{ \ [owen nn nn nee ne nomen cen nn connor nseneononwewnnrne | | zag] TY JOB/SESSION NUNBER | 20 (entry 1) 
| \ 1 UNUSED | | | erecwwrocnwenncoenennne wewerecwnecosonccecseee= 
| \l------ erence cen wenn nnn anna nen nnn nena nner neernn | | { 2nd half of J/S nunber unused in HPE V/E | 1 
| /{ VIRB INDEX | KODA | ee oo wacwewenorenanennnennanennnenennesescn= 
| | |enennnwnnnnnnnnennnncnnron nee cennennosecnroneoe| | j TY | Initiator Job/Session nunbder 1 2 
| / | LODA | 1 ——_ Jereeeee eoewwcerenwensnocerereseerernn= worcocene 
|WEV 2__/ | enenneen enna n-- nnn ennane ene ncseeeenneeenecencos| | | nd half of J/S nunber unused in MPEV/E | 3 
| \ | PSEUDO EXTENT SIZ°{sectors) | | | connec nw ewe e monn nnn nn ne nnennewnnnnnocoserenneen 
| \ [eneen nnn nn = cone eee nn nne nc cereera re semmnwerns a8 | | | Initiator job/session nane (4 words) | 4 
| \ | UNUSED | | | | 
| \ |onnnn anne nn nce erence erences coe raenerorececes | | | | 
| /| TRB INDEX | HODA | | |noeenee aeenenncncenenennenene- eoeneneenenenen== 
| | |erenn nnn n nn nnn nnn nn nnnn eno rrenen nn nenerorercre | | Initiator user nane (4 words) | 10 
| / | LODA | | | 
[LDEV NNN {  |-nn-nn-nennnnn neem nnn annem nn ncnnner on ceenerncen= | | 
| FSEUCS EXTENT SIZE(sectors) | | eeccen ance ewe wnnccwn cones owen ne necnnnonenesase= | 
| \ [ernew nn conor nme nn renee s rer oo renareeswrwoe ser ne | | | Initiator account nane (4 uords) | 14 
| \ | UNUSED | | | | 
| \ [enn -ner enone ees ccec rer ne scr ne nn renen serennnn nee | | | 
| /| VITAE SNCEX | HOOR | \ | pane nnn nena nn nn nen nnn nnn nnn nnnnn nnn nencnsonen=| 
| | |envcee ene nnennn ene crenn nn enc ernnennnerownes = one | | | Initiator’s logon ldev nunber | 20 
/ | L50R | acon reece Seeeeererse eee 
[LEV 999_f  [nnnnnenne-nnecn nnn nnn nnrrennnn nen rrneenrroenrnn | | | Initiating date | 21 
\ PSEUDO EXTENT S1Zé (sectors) | | [eee e een nnew omen ennn meen nennnennecoenone ssessese 
| \ [ecec nes n ween ennecne a neec cnn nnnnenenernomen seen | | | Inatiating tine (2 words in CLOCK format) | 22 
| \ | UNHISED | | wowncnnnennnnnncneneneweonencccenneneneweoenone| 
| \ [rneonn neon ne nner nen coset ne sc erresmrnnwnreernr ns | ! : 2 
| Device RCD's are pointed to by the Device ACD table. The { 13. 4s 
Device ACD table is stored in DACODST.PUs.SYS. When the | enwannnnennennnwenew enn ennenencenconnsncnenness| 
1 | 
| 
| 
| 
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Information on uho, when and where a job is streaned will be displayed 
in the job’s SSTOLIST. This ane pau be put in the Job Security 
23. 


17- 54 


Job Security Master Table 


faster Table at job creation tine. 


The JSEC OST is sinilar to the JART, there is one per systen. JSEC 
will have the sane entry size and total size as the JNAT. The JHAT 
index will be used to allocate, access and deallocate JSEC entries. 
INITIAL will create or recover the JSEC the sane way it does the JNAT. 


The JSEC is preserved on disc in the file JSECDST.PUB.SYS. INITIAL 
will create DST 275 using the contents of JSECOST.PUB. SYS. 
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Access Control Definition 


Rn ACD consists of the RCD HERDER followed by a naxinun of 20 entries. 


The ACD HEADER has 3 conponente: NUMBER OF ACD ENTRIES, ACD CHECKSUM 
and ACD VERSION. The ACD VERSION includes the ACD RELEASE NUASER, the 
RCD UPDATE DATE and the ACD UPDATE TINE. 


NUMBER OF ACD ENTRIES: Nunber of entries currently in this ACD. 


RCD CHECKSUN: A nunber representing the EXCLUSIVE OR of all the 
words that comprise the entries in the RCD. 


ACD RELEASE NURBER: A nunber representing the current ACD softuare 
used to create the ACD. (NPE V/E VD4 = 5) 


ACD UPCATE DATE: Date when the ACD was last nodified(CALENDAR fornat). 
RCD UPOATE TINE: Time when the ACD wao last modified(CLOCK format). 


There can be a maxinun of 20 entries. Each entry consists of an RCCOUNT 
NANE, USER NRAE, and the SECURITY NOCES qrantes to the specified user. 
Wild cards can be used instead of ACCOUNT WANE and USER KANE. The only 
valid wild card user specifications are: 


@. ACCOUNT 
@.@ 


"@." is represented internallt with the character "*". 
Entries are sorted as per the following exanple: 


SAN. ACCTING 
TON. ACCTING 
@. ACCTING 
ROSE. FINANCE 
@. FINANCE 


Each entry consists of: 


ACCOUNT NAME: The account nane specified by the creator. Upsh:fted, 
with trailing blanks added. 
USER NAME: THE USER nane specified by the creator. Upshifted, 
with trailing blanks added. on 
SECURITY NODES: This is the werd indicating the access/pernission 
the user is granted. It is 2 bytes (1 word). 


012345 6 7 8 91011 12 13 14 15 


1R | Ul xX} Al L) UNUSED | Z| UNUSED | d 


SOS C08 OOSOS8ESE4 C6 04 6 088 BEBE 8 OO8OOS OE DOS OHOOMED 


Note: 2 = Pernission to read SCD, N ® No access 
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Access Control Oefanation 


Access Control Definition 
|An Recess Control Definition (ACD) has the following fornat: 


| 
It 
f Nunber of ACD entries aa ea 
|| ACO checksun | | 
| |ewoen anne enennnennnneeennne (ACD HEADER 
t ACD release nunber aca |! 
|] ACO update date | {Aco | 
| Jew w nn een nn cen enone nowccnnce | (VERSION | 
t ACD update tine (2 words) | | 
t Recount nane (4 words) a , 
f User nane (4 words) td ENTRY 1 
. Security nodes | 
i Account nane (4 words) | | 
1 User nane (4 words) ae ENTRY 2 
security nodes | 
| e e 
|. 
|. 
| | 22 BO GOGanandeo EP ST Ob Gh a Ow A eb ie US ED ee | OS ae le a ae 
| Recount nane (4 words) ! | 
7 User Nane (4 words) | ‘ag ENTRY 20 
{| Security nodes | | 
| |-nncerceeenennne ereccencons | -noeeee 
| 
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Ressage Files 
HAPTER MESSAGE F 
Hessage F a 


This chapter contains the data structures necessary to support nessage files. 
The first section details the message file’s version of the faniliar file 
systen data structure, such as the file label, file control block, and the 
eccess control block. 


The second section shous the tables used by the basic IPC nechanisn uhich is 
a set of internal, NPE procedures designed to support the "boundary condi- 
tions” of IPC files. For exanple, signaling a no wait reader that its record 
has arrived. See the section’s introduction for a detailed descripticn. 


File Structure 


[-s-s-<s=+ weeccewenecnnnoe=| END OF FILE BLOCK © START OF FILE BLOCK 
| OISC ADDR CF EXTENT O | 


\-- 
| DISC ROR OF EXTENT 1 | 


| DISC ADOR OF EXTENT 2 | 


| DISC AODR OF EXTENT 3 { 


| 2 OOS 02229288 2S2OS804988088 28082080 | 


@eee 


S26 OS SC 0 O802280SS028806 880080888808 


| DISC ADOR OF EXTENT n-t = | 


| 
| OISC ADOR CF EXTENT A 


t €e e e e ° e es s e 


The EGF and SOF are exanples only, neant to shou: 
1. The start of file noves into the extent nap as records are read. 


2. The file can wrap around end, hence, cause the SOF to be greater than the 


Uhen a file becones enpty the SOF and ECF are reset to the first block of ex- 
tent zero. 


Each extent is conposed of a nunder of blocks. Extents all have the sane 
nunber of blocks. Extent zero also contains space for the file label and 
user labels in the exact sane format as standard files. Starting with block 
zero, sufficient blocks are allocated to the file label/user labels to satis- 
fy thear space requirenents. 
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Message Files 


Extents outside of the SOF/EOF range may not exist. They are deleted at 
close tine when there are no more uriters accessing the file. 


Block Structure 


weeccwscwcccccosccuweescoce | RARARAAAARAARARAARAARAARAARARRAAARARE 
| FIRST DATA RECORD l 

|-nnnneneneocecenenenneceen= | EXACT SANE FORMAT AS STANDARD 

| SECOND OATA RECORD | VARIABLE LENGTH BLOCKS. 

| eevee comes cccoccocneasooore 

| LAST DATA RECORD | 

| RECORD DELIMITER (-1) 

we awsecnsecoecescassocce mee RAARRARRARRRARARAARAARAARARARRARRAARR 


PTY SPACE (NEXT RECORD 
OULD NOT FIT) 


zm 


PESOS OSS SSSOSSSSSE8SLOTSTTOO 


Separating the data portion of the records fron their header enables the 
standard file systen access procedures to read the records with no knowledge 
that they are nessage file records. 
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Message Files 


MNessaqe Access Control Block 


Notes: 


1. 


Uords/fields that do not pertain to nessage files are left 
blank. 


This diagran shous the "conbined” ACB as it appears to 
the nessage access procedures (the procedures in IPC). 
Thus it is a combination of the LACB and the PACE. 


345 6 7 8 9 10 41 12 13 14 15 
od pes eed eed ped a ed ped rd bd ede 
-5| OST NUMBER OF THE PRCB {-5 


OS O98 OBSS O22 6 OS 4 ©8228 SSSE4E 6 68S 42 22424628 SE4 SESTOBSSTOO 


{ 
-4| PRCB CONTROL BLOCK VECTOR TABLE ADDRESS |-4 


-3| DST NUMBER OF THE LACE |-3 


<2| |-2 


~1| |-1 
| 
O| | SIZE OF THE ACB INCLUDING BUFFERS (WORDS) |0 


1| FILE NUMBER i" a 
2| FILE WANE 2 & 
“ - & 


| 2 BOBO SO OS 8 BOS BEF OO 8 SS 2 2408 SSS SE8 ©8988 SSOSSSBO8OE8 | 


6} FOPTIONS 16 & 
| 2 2SS@ 692882 OF EE ©HC 2 OBB SBDlPFASLESE TE GE TE APE De TH GR? Oe NSE Be AB ae 
y) ROPTIONS y & 
10} RECGRD SIZE (BYTES) it & 
11] BLOCK SIZE (woReS) j9 * 
12] 110 
| eee we ees. coe Oe ce SOS Oe Cee we tees e Caeseeewee eeeceon 
12] CASPIRGE CONTROL CODE (WRITERS) 144 
14] is & 
15] 113 
| eons nnn enn ee wenn nnn nnn enon cee en enn ow ecnennnnn= | 
6.23.00 
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Message Files 


Record Fornat 


Length word’s value does not include itself. 


Header Fornat 


| | 
| cjLc] EU | HEADER TYPE|O 


| WRITER’S ID \-1 


C (0:1) - Set on if this was the last record written before 
the systen crashed. This bit 1s set on by the 
first open on the file after the crash. 


LC (1:1) - Valid only for close headers. Set to one if this is 
the last writer to close the file. 


EU (2:1) - Set for the last record written before the file label EOF 
was updated. 


Type(8:8)- 0 - data 


1 = open 
2 - close 
6.23.00 
18- 3 
Message Files 
flesgaae Access Contro k n 


—— ee eee Ho eee + ee 


345 6 7 8 9 10 11 12 13 14 15 


16} ERROR CODE 14% 
17| TRANSMISSION LOG (UNITS SANE AS LAST RD/URITE 115 * 
20| TOTAL MUNBER OF UNREAD RECORDS (INCLUDES [16 
2] OPENS AND CLOSES) = 117 


aa BLOCK NUNBER OF THE FILE'S TAIL (RELATIVE TO {18 


23| THE START OF FILE BLOCK) {19 
24] LOGICAL RECORD TRANSFER CONT. \20 
so; 0tt<CStés eS lot 
a6| PHYSICAL BLOCK TRANSFER CONT \22 
a jee eet eee |23 
ao| DST REL ADOR OF READ HERDER SSS \24 
41| 0ST REL RODR OF UAITE HERDER 
22 ~~ CC \26 
43] FC VECTOR TABLE OFFSET. SS \27 
| SnaRe Count (wunBER OF LACB’S) ds 
95| ACCESS CLASS, STATUS, ES {23 
36| LOGICAL device MNSER 130 
> ae rearran eauaaa yeu ot iat 
40| OST RELATIVE ADDRESS OF NEXT RERD RECORD [32 
41| SIZE OF IME BUFFER (uaRDS) 133 
ene Ce [34 
ainmm 135 
4a| MOMBER OF READ LACS'S 136 
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Ressacse Files 
flessace Acces ntrol Block (Cont. 


1234 5 6 7 8 9 106 11 12 13 14 15 


| 
45| TYPE AND DISPOSITION 


| 46] ACCESS RASK | RECORDS PER BLOCK 138 


l 
47| MISC. ASG FILE FLAGS 


| 
5S0j0 | # RO BUF | WUT BUF JER{QuUIN (C |D IS IF | 


eo | weeceeewoenee | ecocoesoeoeoenos j eelfee [oo --|--]-- oo 


| 
51| NUMBER OF FREE WORD IN THE CURRENT FREE RECORD|41 


OSS OSC OS 6 OS OS 6 OS 0 S28 628 £29862 28 S248 2OS8 48088882 


| 52] NUMBER OF FREE RECORDS 142 
Wee [43 
i eal aaa OE ADOT ECMIOS INET lea 
1 ss 145 
i-oG6k ost RELATIVE ADONESS GF INE GET UNITE RELOAD A 
Homme onus \ 
| 60] LAST READ ERROR | LAST URITE ERROR lee 
‘imine oo 49 
1 sal nen aecono's ITER DD 
| cal am mosis epee 
1 gal pst acu mooness OF THE PRED ne 
| ssl oT EL DOES OF TLS aoucen | 
eel os MUGTHEomESS OF METER CE teh 
| eal Stace os? RELATIVE ADDRESS OF DO 
| ol TRS Te 56 
| 71f RESERVED FOR CALLING PARAMETERS? 
Ree Is 
Oe cee ~ [59 
|orwa nanan nnen--ncene nnn ennnnneeenennnnnnen nn | 
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Message Files 
flessage Access Control Block (Cont. 


0123 4 § 6 7 8 $10 41 12 13 14 15 
|--|==|=-|-=1-=]--1-=f--1-=]-=l-=1-=1-=1-= f= l= 


| | 
| 125] WAITER’S REPLY PORT. O2USING ACB COMPLIN RREA te 


| 126] WAITING PROCESS’S PIN 186 
| 127] catring piociss's FE MER 
Be greener acm 
| son aesvutant ERROR CODE Servers gs 
| 32 RESULTANT TRgnaseION Lag 
wnmate CO aamaeiees 
1 saal ost AEL nopRess OF Fins? BUFFER Ce 
| 196] OST REL ADDRES OF BUFFER THD i 


* Value is private to a particular accessor. 


oe 3. 
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MNeesace Recess Control Block (Cont. 


01234 5 6 7 8 9 10 11 12 13 14 15 


| Je-|e-l 
| 74] RESERVED FOR THE STACK MARKER FROM FILE SYSTEN|60 


| 
| se INTRINSICS i 


| 
| 100] USER'S SOFT INTERRUPT PLABEL |64 * 


| 
| 101] # OF SECONDS TO WAIT ON BOUNDARY CONDITION {65 * 
| 
| 102] OJEX|NDIVRIGTIIMIC Ju | CARRIAGE CONTROL 66 * 
| 
| 


| I--| 
103| REPLY PORT (BASIC IPC PORT) |67 * 


er 68 * 
| 105{ NOUAIT WRITER RECORD BUFFER ADORESS i69 * 
| 1061 NOWAZT URITER RECORD BUFFER OST. 170 * 
1407] MOUAIT URITER BUFFER ENTRY NUMBER 718 
| 110] NO WAIT 1/0 RESULTANT ERROR CODE == [72 * 
1119] NO WAIT 1/0 RESULTANT TRANSMISSION LOG | 173 

1192] MO MATT 1/0 FREAD TARGET DST tS [74 * 
| 113] NO ATT 1/0 FREAD TARGET RODRESS 113" [75 * 
| 194] WRITE WAIT QUEUE (BASIC IPC PORT) ss 176 

| 198| RERD WAIT QUEUE (ORSTC IPC PORT) 7 


| 
| sag fo WRITER ID tg 
} 121] LOCAL FLAGS (81 


| 124] LENGTH GF TRRGET AREA 184 


OPS OS OSS POS SES SS 8 @ © OS 2202S 22OS8SS O98 22 92 S9SE 20 22a | 
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Word Field Description 


Pt) File’s global flags. 
(134) - nunber of read buffers 
(5:4) - nunber of urite buffers 
a ER 1 - extended read 


wait queue. 
(11:1) 1 - wait msg is located in the ACB 


(12:1) C 1 - conpleticn msg is located in the ACS 


Message Files 








(13:1) 0 41 = the current write buffer has dirty bit set 


(14:1) $ 0 - the start of file is block zero 


(18:1) F 0 - the ACB buffers have not been filled 


2102 Recessor’s local flags. 


(0:1) 0 1 - have not yet issued an FRERD/FURITE against 


the file. 
extended wait node. 


a ht © at od 


¢ 
Toe eee 


wait disabled and just cpened. 


deny ASSEN 


do not destroy the next record read. 

writer has not yet written first record. 
transnission log should be expressed in words. 
bytes. 
cnly user node procedures can be soft interrupted. 
no wait completion message is in LACB area. 


carriage control character to be used for 


the uriter’s record (a value of one indicates no 


carriage control character). 
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¢ 9 
) QU 1 - one or nore uriters has been queued on the 





Message Files 


MASTAT Definitions 


Octal 
Value Event Type Paraneter 1 


72/0 Read init # free rec 





Paraneter 2 








72/1 Read conpl (0:8) error, (8:8) ID  Nunber of records 

72/2 Write anit (0:8) @ rec, (8:8) I0 Nunber of free records 
72/3 Wrate conpl (0:8) error, (8:8) I0 Nunber of free records 
72/4 Centrol (0:8) error, (8:8) ID (0:4) func, (4:12) parn 
72/5 EOF (0:8) error, (8:8) ID Number of records 

72/6 Open (0:8) error, (8:8) ID Number of records 

72/7 += Close (8:8) Wfree, (8:8) ID  Nunber of records 

72/10 Initiation 0 (0:8) fix, (8:8) update 


73/0 Put record (0:8) error, (8:8) IO (0:3) rec type, 

(3:13) nunber of records 
73/1 Delete rec (0:8) error, (8:8) ID (0:3) rec type 

(3:13) nunber of records 
73/2 Delete blk Start of file block @ End of file block # 


Notes: 

1. The aa/bb notation in the “octal value” colunn denotes type/subtype. Type 
is the actual MASTAT event nunber. Subtype is (0:4) of paraneter 0. 

2. Several itens can possibly exceed their fields, in that case the bits 
beyond the field are lost. These itens are nunber of records, nunber of 
free records, start of file, and end of file. 


3. Paraneter word zero has a conncn fornat for all the MASTAT events. 


Field Description 


(0:4) Event’s subtype. 
(4:2) File’s state 
0 - enpt 


y 
1 - partially full 
2 - only a fraction of a free record is left 
3 - completely full 


(6:1) Nonzero indicates that there is one or nore 
waiting readers. 


(731) Nonzero indicates that there is cne or nore 
waiting writers. 


(11:1) Nonzero indicates that the write has a carriage 
control character. 


(12:4) Flags local to the accessor. 
(12:1) - the accessor has done no FREADs/FURITEs 
(13:1) - extended wait 
(14:1) - nondestructive read 
(15:1) - urater has not written any records 


6.23.00 
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Reader and Writer Wait Queues 


Uhen an enpty message file is accessed by nore than one reader 
(share), then there nust be a uay of having the readers’ FREADS 
satisfied in the sane order that they uere issued. That is, there 
nust be queue of waiting readers. The IPC access procedures 
acconplish this by dedicating a basic IPC port as a “read uait 
queue". Uhenever a reader's request is stalled because the file 
18 enpty, @ nessage is sent to the read wait queue. Subsequent 
FREADs by other processes will queue up behind the first reader in 
a FIFO nanner. fin FURITE will take the firet entry fron the wait 
queue and send a "read nay be done” nessage to the reader’s reply 
port. 


In a like manner, multiple uriters will queue on the write wait 
queue when the file is full. 


Conpletion Notification For Nowajt 1/0 


The IOUAIT intrinsic waits for a message to be sent to the reply 
port(s) of the specified user files. 


Tineouts 


When an accessor encounters a boundary conditicn (i.e., a reader 
accesses an enpty file), it nay specify that the condition nust be 
satisfied in x seconds (FCONTROL 4). To this end the IPC access 
procedures nerely issue the FCPORTSEND to the wait queve with the 
user's tineout value specified. The tinecut will tear the nessage 
fron the wait queue and place it cn the accessor’s reply port. 
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File Systen Basic JPC Definitions 


The objective of this set of uncallable procedures is to provide a 
sinple IPC mechanism to support the IPC file access procedures. It 
enables one process to send short, control nessages to another process. 


General Behavior 


FCPORTOPEN Proceaure 


The heart of this mechanisn 18 the port. & process desiring to 
receive nessages would first open (create) a port. This process is 
termed the "port manager". When the port 18 created, a port nunber is 
returned to the opener. Since the port nunber value cannot be knoun 
in advance, potential senders need sone method of obtaining the port 
nunber fron the port manager. 


Both the ports and the nesssges are contained in a single disc 
resident data segnent. There can be a total of over thirty-five 
hundred open ports and outstanding nessages, therefore, ports and 
message blocks are not scarce resources. 


FCPORTSEND Precedure 


This procedure sends a0 to 5 word nessage to a port. Optionally a 
tineout value may be specified which will linat the duration the 
nessage will renain attached to the port. Expiration of the tineout 
causes the nessage to be deleted fron the target port’s queue and 
placed on the sender’s reply port (specified by the sender in the 
FCPORTSEND procedure call). 


FCPORTRECEIVE 

Reads and deletes the head nessage fron a port. The sender’s return 
port number is also given to the receiver, enabling hin to send a 
reply nessace. 

FCPORTCLOSE 


Denclishes the port. 


IPC File’s Use Of This Mechanisn 


All open message files have tuo ports open for the file (read wait 
queue and urate wait queue), plus one port per accessor (reply port). 
Their use is described in the following. 
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Message Files 


Port Data Structures 


Port Data Seqnent 


PORT DATA SEGRENT | GLOBAL AREA 


REMAINDER IS 
COMPOSED OF 
“BLOCK SIZE" 
CHUNKS. 


The chunks are a conbire*:on of free entries, ports, message queue 
entries, and taner list entries. 


Port With Tuo Outstansing Messages 


| ---------on-| | -oo-- enone | -eneneo ence 


| | >| | 
| PORT | } meer | } mee2 | 
| | | | | | 


| eg2eae @ar Ze eeoe | | eaeaeweoaeceuve2o | | 2822S E2SESOOOE288 
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Message Files 


Port Nunber 


1234 5 6 7 8 910 11 12 13 14.15 


| 
JPORT INDEX | PORT DATA SEGHENT RELATIVE ROOR/8 | 


Port index ~ Index into the port OST nunber array 


Port DST Nunber Reray 
Located in Systen 08 Extensicn Area. 


100] PORT CATA SEGHENT NUMBER |64 
101| RESERVED FOR A SECOND PORT SEGRENT i 
6.23.00 
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Port 


60123 45 6 7 8 § 10 11 12 13 14 15 
[== |-=1-=]=-]==]-=1-=1-= [== 1=-1-el-=1-=1-= 1-1 


| HERD ME ACORESS 











limos CN 
seo | nee pear UUER aN POAT LEST TEL 
aly (waved | pin on Peat Owe 
Al Giimcmet ae 
s| wRGER OF ROES IN THE PORT’S GUEUE IS 
6| wuRBER OF SEwDS 10 THIS PORT Is 
STINET sa 7 
| 


y SOFT INTERRUPT PLABEL 





E Enable wake up bit 
0 - Do not awaken the process 
1 - Ruaken the process 


U type Action to be taken on an enabled port uhen a reseage is 


received 
© - Ruaken the process on a nessage wait bit 
1 - Generate user softuare interrupt 
2 - Generate systen sof tuare interrupt 
I Interrupt node 
© - Both priv and user node code can be interrupted. 
1 - Only user node can be interrupted. 


Subtype Soft interrupt subtype 
1 - Message file softusre interrupts. 
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an nee 


Port Data Seqnent Global Area 


4| BLOCK SIZE IN WORDS |1 
imine. 1, 
s\ mann MeO eLOS. 13 
a “Conngnt MURDER OF FREE GLocKS SSS \4 
[Meco Is 
lm i6 
nie °° 1? 
to wean OF INPEDED PROCESS IST. SSS is 
11} "tail OF InPEDED PROCESS LISTS l9 
12|" HERD OF TInEOUT TwRERO (TOE ADDRESS) lho 
Won Mi 
14{ VALUE RETURNED BY TIMER INTRINSIC UHEN Ine 
1s; TaNeQuT uns IMIIANED «=O 13 
16 HERD OF PORT LIST (IN UNITS OF PORT KUNBERS) [16 
17 ¥oT poo ne eee en r 
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Message Queve Entry (NgE) 


| 012 34 § 6 7 8 9 10 11 12 13 14 15 


O| NEXT AQE ENTRY; IF LAST, (PORT ROOR) LOR? 10 


1| PORT NUMBER OF RETURN PORT |1 
g\TIne LIST EWIRY (TLE),OenD TIREOUT,-toTIRED uTI2 
ime 3 
men le 
emmeni oo Is 
c|Psanciek Tae fli arene ta f 


" PRFARETER FOUR {7 


Timer entry definitions - 0 - no tineout 
1 - timeout expired 


Message Files 


Ressage Files 


2 - TLE addrese for a pending tinecut 


File Systen Message Fes 


Wart Message: 


pac 
> - UPITER Td 
1 - ,OCAL FLAGS (d:ffer with each accessor) 
(0:1) - accesscr just cpened fire 


(1:1) - wall wait on boundary conditson if no synbiotic process 


(3:1) - urater has not wratten a record 
.4:4) - transnission log in bytes 
(8:4) - carriage control code 


2 - OSTH of data buffer 
3 - Address of data buffer (DST ~elative) 
4 - Length of data bulfer in bytes 


Conpletion Nesseje: 


O - Resultant error cede 
1 - Resultant transmission log ir cytes 


G.23.M 
18- 17 








Nessage Files 
Tuner List Entry (T 


| 0123 4 § 6 ie f cf esr sp 
NEXT TLE (SORTED IN INCR TIME VAL), O IF lay 
| enon nnn nen meno nen mene nnn nnn nnscceerrnrareecorec= 


1] PRECEDING TLE ENTRY (0 IF FIRST ENTRY) \1 
al Sanaee OF AILLISECONDS THE TIREDUT VALUE {2 
al “ge iarg TUE 1S BEvOND THE PREVIOUS TE I3 
al "aooeess OF WE AFFECTED MESS \, 
mor hemeseT |, 
g| Gauue OF TIRER UnEN THES TINEOUT EXPIRES |S 
| (auisecos) | , 


MASTAT Definitions 











Octal 
Value §vent Type ParaneterQ Paraneter 1 Paraneter 2 
62 Open Port nunber Port DST nun Flags paraneter 
63 Receive Port nunber QE address Return port 
conpletion 15:1 Waatspe 
64 Send Port nunber QE addrese Return port 
15:1 Q type 
65 Change Port number 0 = enable Head MQE 
status 1 # disable address 
66 Abort Port nunber Paraneter Return port 
zero 
67 Close Port nunber Port OST # open 
ports left 
7 Expand Port OST nun = # expand blks Total # 
blocks 


71 Tineout Port nunber QE address Return port 
expired 
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Message Intrinsics 


SENDNSG 
Procedure SENDNSG(Destpin, Subqueue, Msglength, Flags); 
Value Destpin, Subqueue, Msglength, Flags; 
Integer Destpin, Subqueue, Msglength; 
Logical Flags; 


Option Privileged, Uncallable; 


Destpin, Subqueue, and fisglength have to be within range or @ Systen Failure 
622 will occur. 


The caller of SENDMSG stacks the nessage <cntents before calling the proce- 
dure. SENDNSG expects the first msg word to be at C-7-Msglengeh, and the 
last msg word at Q-8. The message contents at Q-8 to Q-7-Msglength are 
deleted fron the top of stack ty the exit fron SENDNSG to the caller. 
Flags.(1:1) = 1 = Wake-up destination process fron a nessage wait. 


Return CC = CCG if process was already auake else CC = CCE. 


PORTSTATUS 
Logical Procedure PORTSTATUS(Subcueue); 
Value Subqueue; 
Integer Suoqueue; 


Option Privileged, Unca. lable; 


When supplied a valid subqueue nunber, FORTSTATUS returns a true valve if the 
subqueuve is non-enpty and a faise value if the sudqueve is enpty. 


When passed a -1 a subqueve paraneter, PORTSTATUS returns the subqueve nunber 
of the process’ nost urgent non-ennty sutsueue (the snaller the nunber, the 
nore urgent the subqueue). 

If all eubqueues are enpty, PORTST&7US returrs (C = CTE. If at least one 
subqueue is non-enpty, PORTSTATUS returns CC = CC%. 
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CHAPTER 19 MPE_RENORY RESIDENT MESSAGE FACILITY 
Overview of Facility 


The nenory resident message facility of APE V addresses the need for an effi- 
erent, sinple, and uniform nethod for systen code to send short status-type 
messages to processes. 


Each process is created with a "port" in the nessage harbor table (OST 271) 
which supports a set of nessage subqueuves which are private to that process. 
There are a naxinun of five subqueves per port in the initial inplenentation. 
This lanit can be easily extended uhen new subqueves are required. 


Any systen code, even code running on the ICS, can send a message to any sub- 
queue of any process. The destination process’ PIN nust be known, any 2 
prior, conventions on subdqueve nunber and message fornats nust be es- 
tablished. The caller of SENOMSG nay optionally specify that the destination 
process be awakened fron a nessage wait. 


A message can be any length up to the configured naxinun. Message length is 
specified in the call to SENDMSG and RECEIVENSG. In the initial inplenenta- 
tion, messages are limited to 6 words in length uth 4 words available for 
data. This naxinun can easily be increased if the need arises. 

By calling PORTSTATUS, a process may at any tine determine whether a 
specified subqueue is non-enpty or obtain the subqueue nunber of the nost ur- 
gent non-enpty subqueue (lowest nunbered one). 


By calling RECEIVENSG, a process nay receive the message at the head of the 
specified subqueue. This receive is optionally non-destructive. 


A process can wait on a message wait, or cn a combination of neseage wait and 
other wait types. 
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MPE Nenory Resident Message Facility 
RECEIVERSG 


Procedure RECEIVENSG(Subqueue, Msglength, Flags); 


Value Subqueue, Msglength, Flags; 
Integer Subqueve, fisglength; 
Logical Flags; 


Option Privileged, Uncallable; 


Subqueuve and fieglength has better be uithin range or a Systen Failure 622 
will occur. 


The caller of RECEIVEMSG does an ASSEMBLE(RODS Reglength) to make space for 
the nessage contents. RECEIVENSG stores the nessage contents into 0-8, 
Q-9,...,0-?-Msglength. Q-7-Msglength contains the first uord of the nessage. 


ie z do not release nessage fron head of subqueue (non destructive 
read). 
Return CC = CCG if all subqueues were enpty, else CC = CCE. 


101 1 2] 31 41 S| 6 
|-=|-===|-={--1-=1-+| 
JUS} Ll DATA { 


LS = Subqueue or Link 
L ® Length (2-6) 
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APE Renory Resident Message Facility NPE Renory Resident Message Facility 


in rutt Messace Harbor Tab Cont. 
flessage Harbor Table Fort 

OST = 271 (57) Jeu - 

ol ost INoex wungER 271) | jae es i 

| "gata seenent Size ao 2 

ol “ysen ReGiOn POINTER | can {3 

i Sedm maneek OF ADS 1 | faa \ 

amas ee ieee is 

ames Vaeme {6 

é|”RESSAGE POOL MEAD POINTER | come. \? 

7\"RESSAGE POOL TAIL POINTER | cgi. \s 
| 40} AVAILABLE RSG FRAMES COUNT | Weis tS ‘9 
| nf "neRD OF INPEDED QUEUE | ere ae c 
| tal tREL OF INPEDED QUEVE | cc tf 
| 131 ARN W OF PENDING NSCS | er ae 12 
| 14 CURRENT © OF PENDING nscs | lsum “hh 


| 
| 16] Su8d 4 HERD 114 


| 15) PORTS (16 WORDS ERCH) | 
| (6 FOR HERDER + 2 LINK WORDS fe tr nrn rere rnnwowownnenucecoecs 
| FOR EACH OF 5 SUBQUEUES) | | ss SUBQ 4 TAIL fi 
| MESSAGES (6 WORDS ERCH) | 
(2 FOR HEADER + 4 FOR DATA) 
£*& Note: The Message Harbor Table serves as the Systen Port Data Segnent. 
The Ports Facility also allows the creation of additional Port Data Segnents 
which have a sinilar format. In the header of a Port Data Segnent other than 
the Neesage Harbor Table, words X13 and 214 will contain the Taner Head and 
the Timer TRLX respectively. Networking softuare is the prinary user of Port 
Data Segnents althoush they also use subqueves in the Systen Port Data 
Segnent (Nessage Harvor Table). 
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NPE Menory Resident Message Facility 


Ressace } rT fn Harbor 
Port/Subqueve Explanations Hessace 
SUBGUEVE USERS: ' 
Subqueue 0 - Various systen process functions. Exanples: Of LINK {0 
PROGEN - OFS Errore ere neenernwnnencosenccoenocess | 
TONESSPROC - Misc. Message Handling 1| LENGTH {1 
SECURITYPROC - Messages for O0lNed Devices | ewno ree eronnenne wocccccencceno| 
Subqueve 1 - User Soft Interrupts 2| j2 
Subqueue 2 - Systen Soft Interrupts (not used) 3| OARTA |3 
Subqueve 3 - Logon Synch betueen DO’START & INITISNHP. Also used 4| \4 
by Networking Softuare. 5] is 
Subqueve 4 - LOAD/LORDER Connunication aac casera 
Each process hes a port # equaling its pin #. Port 0 is the Kernel Port ?| |7 
used by the Dispatcher & Menory Manager routines. The subqueve assignnents } 10] \8 
for Port O are as follous: F | " 19 
Subqueue 0 - Make Absent Port 
Subqueue 1 - Segnent Modification Conplete Port 
Subqueue 2 - Release Region Port Tiner 
Subqueve 3 - Fetch Segnent Port for 1/0 Device Monitors 
Subqueue 4 - Cache Rove Request Port 
Port 4 ie usually assigned to SYSPORTSERVER (pin 4) which has its oun O| LINK | 
uses for the subqueues ae follcus: cocerrecececernnncncocenenene=| 
1| LENGTH | 
Subqueue 0 - Not used | eee neem een nn wenn wen encccewen =| 
Subqueve 1 - Port Segnent Conpletor 2| REQ 10 i 
Suoqueue 2- Port Timeout s—<“—s Pree wr crm coccenne= | 
Subqueue 3 - Not used 3| SUB QUEVE | 
Subqueve 4 - Port Enable es aeesssces Ree eere se 
DELTA TINE 
5] 
eer 
6| REPLY PORT 
7| ! 
[eesene se see ast saeasseee= o---| 
.23.00 6.23.00 
o 6 19- 7 


gut gy ve bee 














Event Nane 


ALCSTBLK 
ALLOCHEN 
AURKEDEV 
BINREAD 
BREAK 
C_ABSENT 
CABORTIO 
CRCHENOV 


CCLOSE 
CCLOSETRACEFILE 
CCONTROL 
COT_ATT 
CGARBAGE 
CONFIG-INFO 
CONF IG-INFO 
CONF IG-INFO 
COPEN 


COPENTRACEFILE 
CPOLLIST 


CRERD 
CREAD 


CSORIVER 
CSIOWRIT 


CURITE 
OC1OC2ACK 


DEALLOCA 
DEALCSTBLK 


DISKBUGCATCHER 


DISKBUGCATCHER 
DISKERROR 


Event 


mi 


we ~n mn wm & * 


CHAPTER RASTATS NTS 


MASTATS Catalog Index 


MASTATS Events 


Event No. Event No. 
DEC. 2 Event _Nane bec. 2 
20 024 (-) * FREAD 62 076 (-) 
12 014 * FREADDIR 64 100 (-) 
82 122 & 
233 351 (-) * FREADLABEL 76 114 (-) 
237 355 (-) * FREADSEEK 68 104 (-) 
139 213 & 
142 216 * FRENANE 80 120 (-) 
14 016 & 
146 222 & FSETNODE 72 110 (-) 
154 232 ® FSPACE 69 105 (-) 
152 230 & FUNLOCK 79 117 (-) 
86 126 & 
7 007 * FUPOATE 66 102 (-) 
221 335 (-) * FURITE 63 077 (-) 
222 336 (-) * FWRITEDIR 65 101 (-) 
223. 337 (-) * FURITELABEL 77 (115 (-) 
140 214 & GIPINTERRUPT 192 300 
& GET_CDT 15 017 
153 231 2 YOBUFTRAP 125 175 
155 233 ® 1/0 COMPLETION 141 157 (-) 
* INITIATE 84 124 
147 223 * IOQUAIT 67 103 (-) 
® LINK REG 89 131 
160 240 ® MAKEDC 1 001 
* MAP_CON 87 127 
150 226 a 
144 220 ® fMONOFF 229 345 (-) 
® PFAIL 24 360 (-) 
149 225 * PROCESS COMPLETE 211 323 (-) 
231. 347 (-) * GONOBJ 0 000 
® QUE LOR 16 020 
13 015 * QUIESCE 40 050 
21 025 (-) * RELRESOURCES 23 027 (-) 
# REQCACHE 9 132 
200 310 ® SEGIO 5 005 
& STODN-ENTRY 194 302 
201 311 ® $TO0n-EXIT 195 33 
100 144 (-) * SIQDONE 6 006 
& SIOP-wST 193 301 
* SOFT’ DEATH 120 170 
6.23.00 
20- 1 
ANSTATS Events 
AMSTAT CATALOG INDEX 
Description Page 
u No. 
MEMORY MANAGER 20-4 
MEMORY MANAGER/CACHING 20-11 
EMORY MANAGER 20-15 
SCHEDULING 20-17 
IPC/NSG FILE 20-18 
FILESYS 20-24 
FILESYS 20-31 
FILESYS/CACHING 20-35 
DISC I/O TRANSFER/CACHING 20-41 
DISC ERRORS 20-42 
SIO 20-43 
DISC SPACE 20-44 
DISC CACKING 20-47 
C$/3000 20-48 
CS/3000 20-51 
CS/3000 20-54 
DISC CONTROLLER INTPET 20-55 
PRIVATE VOLUMES 20-58 
PROCESS CKERTION AND TERMINATION 20-59 
MONITOR CONFIG ZNFORMATION 20-60 
TESNIMAL 1/0 20-65 
POLER FOL 20-70 
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ANSTATS Events 


AASTATS Catalog Index (Cont. ) 


DISKERROR 101 145 (-) *% SPECCHAR 236 354 (-) 
DISKINTRPT 191 277 * SPECIALRO 2 02 
% SPECREAD 238 356 (-) 
® START 1/0 110 156 (-) 
* STACK OVERFLOW 2. 31 
* STRATEGY 83 123 
DISK TRAFFIC 98 142 (-) * SWAPIN 8 010 
OQUE_LDR 17 021 a 
FCHECK 74 112 (-) * SYSPINS 224 «4340 (-) 
FCLOSE 81 121 (-) * SYSPINS 225 341 (-) 
FCONTROL 71. 107 (-) * SYSPINS 226 «342 (-) 
FETCHSEG 4 004 * SYSPINS 227. 343 (-) 
FGETINFO 7§ 113 (-) * TERMLOGOFF 235 353 (-) 
FIND_DE 18 022 & 
FLOCK 78 116 (-) * TERMLOGON 234 352 (-) 
FOPEN/(DA) 60 074 (-) * TERMREAD 200 6 (-) 
FOPEN’ 61 075 (-) * TERNURITE 232 350 (-) 
& TIMESTAMP 228 344 (-) 
FPOINT 70 106 (-) * UN_NAP_RG 88 1H” 


(-) = Events are not logged in floniter Table tut may be logged on 
magnetic tape. 


6.23.00 
2- 2 


MASTRTS Events 


AMSTAT Event Group 0 (Menory Manager) 


Event 0 

EVENT NAME: QOKCB 

DESCRIPTION: ABSENCE TRAP ON CODE/ORTA SEGHENT 
CALLING MODULE: KERNELC 


CALLING PROCEDURE(S): QUEUEGNOBJECT 


Paraneter Description 


P1,P2 = Seqnent Identifier 
P1.(0:4) = Segnent type field 
0 = Data Segnent 
1 2 $L Segnent 
2 8 Progran Segnent 
3. ® Cache Domain 
P1.(4:12) = Progran Index Into CSTBLK (Type 2 Only) 
P2 = Segnrent Nunber 
P3 = SLL Pointer (SLL Table Relative) 
P4 = STATUS Word (Fron Stack Marker) Of Calling (Trapping) Segnent 
PS = P REG Word (fron Stack Marker) Of Calling (Trapping) Segnent 


P6 = Not Used 
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Event 1 
EVENT NANE: MAKEOC 
OESCRIPTION: MAKE SEGMENT AN OVERLAY CANDIDATE - RELEASE 


SEGNENT TO THE POOL OF AVAILABLE SPACE 
CALLING MODULE: KERNELC 
CALLING PROCEDURE(S): MAKEOC 


Paraneter Description 


P1,P2 = Segnent Identifier 
P1.(0:4) 2 Segnent Type Field 
0 = Data Segrent 
1 8 SL Segnent 
2 2 Progran Seqnent 
3. ® Cache Donain 
P1.(4:12) = Progran Index Into CSTBLK (Type 2 Only) 
P2 = Segnent Nunber 
P3. = Bank Of Region 
PAs Address Of Region 


P5-P6 - Not Used 


ven 
EVENT NAME: SPECIALRQ 
DESCRIPTION: REQUEST OF SEGMENT EXPRNSION/CONTRACTION, UNLOCK, 


UNFREEZE, IOUNFREEZE, LOCK, IGFREEZE, FREEZE 


CALLING MODULE: KERNELC, KERNELD, ININ 


CALLING PROCEOURE(S): UNLOCKSEG’, IOFREEZE’, FETCHOBJECT-(KERNELC) 


OLSIZE, ZSIZE, GETPXSEG, ALTOSEGSIZE, 


ALTPXFILESIZE-(KERNELD), STACKOVERF LOW-(ININ) 
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Event 4 

EVENT NAME: FETCKSEG 

DESCRIPTION: SEGNENT REQUEST (FOR 1/0 SYSTEN OR PROCESS) 
CALLING MODULE: KERNELC 


CALLING PROCEDURE(S): FETCHSEGHENT 


Paraneter Description 


P1,P2 = Seqnent Identifier 


P1.(0:4) = Segnent Type Field 
2 Data Segrent 
1 == SL Segnent 
2 3 Progran Segnent 
3. -® Cache Dorain 


P1.(4:12) * Progran Index Into CSTBLK (Type 2 Only) 
P2 = Segnent Nunber 


P3 = Requester ID 
-(0:1) = 1 2 1/0 Systen Request 
. (1315) = Ldev # 
Frocess Request 
.(1:15) = PIN @ Of Requesting Frocess 


TOFREEZE Request 
Blocked LOCK Request 
LOCK Request 

FREEZE Request 


(0:1) = 0 


—b ab wd ot 
eunn a 


Segnent Already Present 
Segnent Is Recover Overlay Candidate 
Searent Already On Its Way In Sar Sonecne 
(Segnert In Motion In) 
Segner® Not Present, ust Fetch 
(Full Fetch) 


a? 
“ 


a 
. 
“ 


P5-P6 - Not Used 
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NASTATS Events 
Paraneter Description 


P1,P2 = Segnent Identifier 


P1.(0:4) = Segnent Type Field 
= Data Segnent 
1 #2 SL Segnent 
2 = Progran Segnent 
3 =? Cache Donain 


P1.(4:12) = Progran Index Into CSTBLK (Progran Segnent Only) 
P2 = Segnent Nunder 


P3= .(0:1) = 1 = If FETCHIOBJECT Is Called With 1/0 FREEZE, FREEZE 
Or LOCK Options 
.(12:4) Type Of Request 

© = JOFREEZE 

1 = FREEZE 

2 = LOCK 

3 = IOUNFREEZE 

4 = UNFREEZE 

5 = UNLOCK 

6 = OLSIZE Expansicn 
7 = DLSIZE Contracticn 
10 = PXFIXED Expansion 
11 = PXFILE Expansion 
12 = PXFILE Contraction 
13 = XOS Expansion 
= 14 2 X0S Contraction 
2 15 = 2SIZE Expansion 
© 16 = ZSIZE Contraction 
= 17 = STRCKOVERFLOU 


P4 = For Types (P3.(12:4)) 


2 0,2,3,5 = P4.(8:8) = LOCK Or IOFREEZE Count 

8 1,4 = P4,(0:8) = FREEZE Count 

® 6-16 = Requested Size Of Area In Words 
s 17 # $ Reg Value When Stack Overflow Occurred 


PS © Status Word If Request Type Is STACKOVERF LOU 
P6 = PDISABLE Count If Request Type Is STACKOVERF LOW 
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Event 5 

EVENT WARE: SEGTO 

DESCRIPTION: EMORY MANAGEMENT READ/WRITE OF SEGHENT FRON/TO 
DISC QUEUED 

CALLING MODULE: KERNELC 


CALLING PROCEDURE(S): PROCESSINITASG, STRRTSEGURITE 


P1,P2 = Segnent Identifier 
P1.(0:4) = Segnent Type Field 
QO # Data Segnent 
1 # SL Segnent 
2 = & Progran Segnent 
3.) ® Cache Donain 
P1.(4:12) © Progran Index Into CSTBLK (Type 2 Only) 
P2 = Segrent Runber 
P3 © Disc Request Index - (DRQ Table Relative) 
P4 = .(0:1) © 1 = RITE START 
© 0 #s RERD START 
-(1:15)s Ldev @ 


P5-P6 - Not Used 




















MASTATS Events 


Event 6 

EVENT NAME: SIODONE 

DESCRIPTION: MEMORY ARNAGEMENT SEGHENT RERD/WRITE FRON/TO DISC 
COMPLETE 

CALLING MODULE: KERNELC 


CALLING PROCEDURE(S): SEGREAOCOMPLETOR, SEGURITECONPLETOR 


Paraneter Description 


P1,P2 = Segnent Identifier 
P1.(0:4) = Segnent Type Field 
= Data Segnent 
1 = SL Segnent 
2 = ® Progran Segnent 
3. = Cache Donain 
P1.(4:12) 2 Progran Index Into CSTBLK (Type 2 Only) 
P2 = Segnent Kunber 
P3 = Disc Request Index - (ORQ Table Relative) 


P4 = .(0:1) = 1 © Write Conplete 
= 0 = Read Conplete 


P5-P§ - Not Used 
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MASTAT Event Group 1 (Men: Ranacer/Cachi 
Event 12 (214 
EVENT NAME: ALLOCHEN 
DESCRIPTION: FOUND A HOLE FOR A SEGMENT REPLACEMENT REQUEST 
CALLING MODULE: KERNELC 
CALLING PROCEOURE(S): RESERVEREGION 
Paraneter Description 
Pi = Requested Size In Pages 
P2 = Bank Of Selected Region 
P3 = Address Of Selected Region 
P4-P6 - Not Used 
Event _13 (215) 
EVENT NANE: DEALLOCA 
DESCRIPTION: RELEASE REGION OF MEMORY TO RVAILABLE STATUS 
CRLLING NODULE: KERNELC 


CALLING PROCEDURE(S): RELERSEREGION 


Paraneter Description 


P1 = Size Released In Pages 

P2 = Bank Of Released Region Base 

P3 = Address Of Released Regicn Base 
B4-96 - Not Used 
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Event 7 


CGARBAGE 
GARBAGE COLLECTION HAS JUST TAKEN PLACE 


EVENT WARE: 
EVENT DESCRIPTION: 
CALLING MODULE: KERWELC 
CALLING PROCEDURE(S): COLLECTGRRBAGE 


Paraneter Description 


Pi = Bank of Source Just Roved Fron 

P2 = ADOR of Source Just Noved Fron 

P3 2 MOVEPAGECNT, Nunber of Pages Just Moved Fron 
P4-P6 - Not Used 


Event 8 (210) 

EVENT NAME: SWARPIN 
DESCRIPTION: SUAP IN A PROCESS 
CALLING MOOULE: KERNELC 


CALLING PROCEDURE(S): SWAPIN 


Paraneter Description 


P1 = PIN of Process Being SWAPPED In 


P2 = .(0:1) = 0 ® Being SWAPPED 
= 1 2 End SWAP 
-(1:1) © © = Normal (Partial SWAP OK) 
= 1 = SUAP Required 
.(12:4)2 0 © Process SWAPIN Conplete 
2 2 No Roon, Hard REQ Nay Succeed 
3 = No Reon, Hard REQ Failed 
4 = SWRPIN Stopped - Nore Urgent Activity 
8 = No Lock Space 


P3 = HARDREQUEST = TRUE = Hard Request On SWAPIN 
FALSE= Normal 


P4-P6 - Not Used 
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Event 14 (216) 


EVENT WARE: 
DESCRIPTION: 


CACHENOV 


A CACHE MOVE (T.E., LOGICAL DISC REQUEST) HAS 
JUST COMPLETED 


CALLING ACOULE: CACHESEG 
CALLING PROCEDURE(S): PROCESSCOTLCGREQOQUE 


Paraneter Description 


P1,P2 = Segnent Identifier Of Target DST (LOR’BUFOST) 
P2.(0:1) = 1 Then This Is A Stack 


P3 = Mapped Donain CDT Entry Nunber 
P4 =z Transfer Count 


PS5-P6 = Unused 


Event 15 (217) 


EVENT WANE: 
DESCRIOTION: 


GET_COT 


CALLED WHEN AN ENTRY IN THE COT T&SLE IS 
GBTAINED GR RELEASED. 


CALLING MODULE: CRCHESEG 
CALLING PROCEDURE(S): GET°COT’ENTRY, COT’FREE’ ENTRY. 
CDT°GET’MD’ENTRY, COT’REL'AD’ ENTRY 


Paraneter Description 


P1 = CUT Entry Nunber 


P2 = Type cf call 

O = Free entry 

1 = Get Frtry 

2 = Get Mapped Donain Entry 

3 = Reiease Mapped Devain Entry 


P3 = If P2=3 Then Leev Entry Nurser 
P4-P6 - Not Used 
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ANSTATS Events 


vent 16 (X20 

EVENT WANE: QUE_LOR 

DESCRIPTION: CALLED WHEN AN LDR IS QUEVED ONTO THE COT 
CALLING MODULE: CACHESEG 


CALLING PROCEDURE(S): CDT’ QUEUE’ LDR 


Paraneter Description 


P1 = Mapped Donain CDT Entry Nunder 
P2 2 LDR Entry Index To Be Queved 
P3 = Queue Type 
212 - COT Inpeded Queue 
213 - COT Active Queue 


P4-P6 - Not Used 


Event 17 (Z21) 

EVENT NANE: DQUE_LDR 

DESCRIPTION: CRLLED UHEN AN LOR IS REMOVED FRON THE COT GUEUE 
CALLING MODULE: CACHESEG 


CALLING PROCEDURE(S): COT*OEQUEUE’ LOR 


Paraneter Description 


P1 = Mapped Donain COT Entry Nunber 
P2 = LDR Entry Index Being Renoved Fron The Queve 
P3 = Queue Type 

112 - COT Inpeded Queue 

X13 - COT Active Queve 


P4-P6 - Not Used 
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AASTAT fi fi flenacer 

vent - “124 
EVENT WANE: ALCSTBLK 
DESCRIPTION: REQUEST TO RESERVE A BLOCK OF ENTRIES IN THE CSTX 
CALLING MODULE: KERNELD 


CALLING PROCEDURE(S): ALCSTBLOCK 


Paraneter Description 


P1 = EIX = CST Block Index Assigned 


P2 = CSTX = OST Relative Index Of Word 0 Of The Firet Reserved CSTX Entry 
P32 N = Number DF CSTX Entries Reserved 


P4-P6 - Not Used 


Event -21 (-225) 


EVENT NANE: DEALCSTBLK 

DESCRIPTION: INDICATES THAT A CST EXTENSION BLOCK HAS BEEN 
DEALLOCATED 

CALLING MODULE: KERNELD 


CALLING PROCEDURE(S): OEALCSTBLOCK 


Paraneser Description 


P1 = EIX = LST Block Index Assigned To The Block Of CST Entries 


P2 = CSTX © DST Relative Index Of Word O OF The Firet CST Entry 
To Be Released 


P32 NCNT = (WAilocated CSTX Entries- WEntries Being Released)*4 
P4&-PG - Not Used 
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vent 18 (% 
EVENT NANE: FINO_DE 
DESCRIPTION: CALLED WHEN NEED TO FIND AN ASSIGNED COT 
DEVICE ENTRY 
CALLING MODULE: CACHESEG 





CALLING PROCEDURE(S): COT’FIND’OE 


Paraneter Description 


P1 3 LDEV Nunber Of The COT Device Entry To Be Found. 
P2 = CDOT Device Entry 
P3-P6 - Not Used 


Event 19 (Z23) 


EVENT WANE: LOCKRANG 
DESCRIPTION: 

CALLING ACOULE: 

CALLING PROCEDURE(S): 
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vent -23 (-%27 
EVENT RARE: RELRESOURCES 
DESCRIPTION: RESOURCES (VDS,NAIN MEMORY, ST ENTRY) RESERVED 
FOR THE SEGNENT HAVE BEEN RELEASED 
CALLING MODULE: KERNELD 
CALLING PROCEDURE(S): RELDATASEG 
Paraneter fr 
P1 = New 08 OST Nunbder 
P2 = DELTA P At EXCHANGEDS Call 
P3 = Status At EXCHANGEDB Call 
P4-P6 - Not Used 
ven 231 
EVENT NAME: STRCKOVERF LOW 
CESCRIPTION: INDICATES THAT S$>2 (NORMAL STACK EXPANSION 
NEEDED) OR THAT S>MAXDATA (STARCK OVERFLOW ABORT) 
CALLING ROOULE: ININ 


CALLING PROCEDURE: STACKOVERF LOU 


Paraneter Description 
P1 = Current process’ PCB RESRBORTINFO WORE 
P2 = Current process’ PCB PROCSTAIE WORD 


P3 = Current process’ S Register vaiue 





P4 = P Reg within nodule receiving overflow 
PS = STATUS WORD of module receiving cverflow 
P6 = PDISABLE count 
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Event 4 (250) 


EVENT NAME: 
DESCRIPTION: 
CALLING MODULE: 


CALLING PROCEDURE(S): 


Paraneter Description 


P1 = ea 


SSISFSONS 
Sica ee ab ee a 


) 
71) 
71) 
71) 
71) 
21) 
71) 
71) 
71) 
21) 
21 
31 
: 
71 


» 

<< ot ot ot 

wn °: 
ee 

a ae ee et? 


(14:1) 
-(15:1)s 


P2 = PCB04(CPCB) 
(0:1) 


eo. 
« 


© oo ~wOH ON & WA - 
ee ee 08 ee 68 of oe 
oad ab af af of od w= A oO 


. e ° e ° 


Paraneter eri 


P1 = Port Nunber 


= wh ed a a wt ot od td wh ot ot ot wh ot 


ah af af ab 2d of 226 ah od 
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MASTATS Events 


AMSTAT Event up 3 


(NOT CURRENTLY ASSIGNED) 


ANSTAT Event Group 4 (Scheduling) 


QUIESCE 

PROCESS SWITCH - STATE OF PROCESS SRVED 
KERNELC 

OSP 


2 SAR - Scheduling Attention Required 
2 CRIT - Process Is Critical 

= HSIR - Process Has SIR 

= PIOVR - Pending PI, Process Critical 
2 HSPRI - Hold SIR Priority 

= IPEXP - Incore Protect Expired 

2 PC - Preenpt Capability 


s AP = + Must Preenpt 
sl = - Long Wait 
= SW = Short Wait 


= TRU - Terninal Read Wait 
z USEQD - Used A Quantun Since Transaction Began 
z HIPRI - Hold Inpeded Priority 
= Allow Soft Interrupts Even Though In 
Systen Code 
= RITBK - pracese In RIT Break 


en - opti Wait 
RG = - Global RIN Wait 
= Rt - Local RIN Wait 
z if - Mail Wait 


2 810 - Blocked I0 Wait 

= 10 - IO Wait 

s UCP - UCOP Wait, RIT Wait 
2 JNK - Junk Wait 

s TIN - Timer Wait 

s INT = Interrupt Wait 
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P2 = Neseage Address/Flags 


P3 = Return Port 
P4-P6 - Not Used 


Event -52 (-264) 
EVENT WARE: 
DESCRIPTION: 
CALLING ACDULE: 
CALLING PROCEDURE: 


Paraneter 


P1 = Port Kunber 


FCPORTSEND 

SEND TO BIPC PORT 
BIPC 

FCPORTSEND 


P2 = Message Address/F lags 


P3 = Return Port 
P4-P6 - Not Used 


vent - =< 
EVENT NAME: 
DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 


raneter rj 


Pil = Port Nunber 


PORT STATUS CHANGE 
ENABLE/DISABLE BIPC PORT 
BIPC 

FCPORTENRBLE /FCPORTOISRBLE 


P2 = 0 = Enable; 1 = Disable 


P3 = Rddress of First Message 


P4-P6 - Kot Used 


8 ee ee 8 ee oe + eee 


" ge 
2g 


. 77 » aD 
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.(1031)8 
~(11:1)3 
.(1231)2 
.(13:1)}8 
.(1431)2 
.(18:1)s 


P3 = PCB13(CPCB 
. (0:1 


°° es s e .7 e e 
OO I I OO 

oon cn & UA) — 

ae 00 0e ce ce we oe 

00 =) <2 a ot 2 

Ret Cage Meme Met Meee? rt? Meat? wt 
weunenenran 


P4-P6 - Not Used 


Event -50_ (-26 
EVENS NANE: 
DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 


1 = SON - Son Wart 

1 2 FA - Father Wait 

1 s IMP - Process Waating To Uninpeded 
1 = SIR Process Waiting For SIR 

1 = TIA Process Waiting For Tine Out 
1 = NEA Process Waiting For Renory 


= DISPOQ - Process On Dispatching Queve 


= L Scheduling Class 

3 € Scheduling Class 

z 0 Scheduling Class 

2 € Scheduling Class 

2 Inter-Process Is Interactive 

2 Corer-Process Is Core-Resident 
rocess’ Scheduling Prioraty 


© — =0 = os = 


NASTAT Event Group 5 (JPC/MSG File) 


FCPORTOPEN 
OPEN BIPC PORT 
BIPC 
FCPORTOPEN 


Paraneter ription 


P1 = Port Nunber 


P2 = Port OST Nunber 


P3 = Flags 
P4-P6 - Not Used 


vent -51 (-Z 
EVENT NAME: 
DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 


ANSTATS Events 


Event -54 (-%66) 
EVENT NARE: 
DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 
Paraneter Descri 


Pt = Port Nunber 


FCPORTRECEIVE 

RECEIVE MESSAGE FROM BIPC PORT 
BIPC 

FCPORTRECEIVE 
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FCASGABORT 
PURGE RESSRGES 
BIPC 
FCRSGABORT 


ion 


P2 = Natch Paraneter 


P3 = Return Port 
P4-P6 - Not Used 


Event -55 (-267 
EVENT NANE: 
DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 


FCPORTCLOSE 
CLOSE BIPC PORT 
BIPC 
FCPORTCLOSE 


Paranete: Description 


Pi = Port Nunber 


P2 = Fort DST Nunber 


P3 = Nunber of Ports Left Cpen 


P4-P6 - Not Used 


Event -56 (-£70) 
EVENT NAME: 
DESCRIFTION: 
CALLING NOCULE: 
CALLING PROCEDURE: 


EXPRNDPORT SEG 

EXPRND BIPC PORT TRBLE 
BIPC 

EXPRNDPORTSEG 


me owe a + eee ere. 


Paraneter riptison 


Pi = Port DST Number 


ANSTATS Events 


P2 = Nunber of Blecke Added 


P3 = Total Number of Blocks 


P4-P6 - Not Used 


EVENT WANE: 
DESCRIPTION: 
CALLING MOOULE: 
CALLING PROCEDURE: 


Paraneter ription 
Pi = Port Nunber 
P2 = Ressage Address 
P3 = Return Port 
P&-P6 - Not Used 


vent -58 (-27 
EVENT NANE: 
OESCRIPTION: 
CALLING MODULE: 
CALLING PROCEDURE: 


vent - % 
EVENT WARE: 
DESCRIPTION 
CALLING MODULE: 
CALLING PROCEDURE: 


TIMECUT EXPIRED 
MESSRGE TIMER EXPIRED 
FCPOSTINEOUT 
FCPOSTINEOUT 


TPC INTERNAL EVENT 
IPC INTERNAL EVENT 
TPC 

MAKERASTAT 
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TPC INTERWAL EVENT 
IPC INTERNAL EVENT 
TPC 

ARKENASTAT 


araneter ripticn 


The paraneter values are a function of the event and the firet four 
(4) bits of paraneter 1, which is a subtype. 


Pl Bits ( 0:4) = Subtype 
( 4:2) = File State 

O = Enpty 

1 = Non-enpty 

2 © Less Than One Full Record Left 

3 ® Full 
) = 1 = Waiting Readers 
; s 12 Waiting Writers 
z 
)s 


( 6:1 
( 7:1 
(11:1) * Carriage Control Characters 
(12:4 


Local Flags 
Event/ 
Subtype Mane P2(0:8) 2 (8:8) 3 
73/0 Put Record Error ID ( 0:3) = Rectype 
(3:12) = @ of Records 
73/1 Celete Record Error 10 ( 0:3) = Rectype 


(3:12) = @ of Records 


73/2 Delete Block Start of File End of File Block 


Block Nunder 
P4-P6 ~ Not Used 
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Paraneter Description 


The paraneter values are a function of the event and the first four 
(4) bits of paraneter 1, which is a subtype. 


P1 Bits ( 0:4) - Subtype 
( 4:2) - File State 


0 = Enpty 
1 = Non-enpty 
2 = Less Than One Full Record Left 
3 = Full 
( 6:1) = 1 # Waiting Readers 
( 7:1) 2 1 2 Uaating raters 
(11:1) 2 Carriage Control Characters 
(12:4) = Local Flags 
Event/ 
Subtype Nane P2 (0:8) P2 (8:8) P3 


72/0 Read Initiation Record Nunber ID Nunber of Records 


72/1 Read Conpletion Error 10 Nunber of Records 

72/2 Write Initiation Record Nunter ID Free Records 

72/3 Urite Conpletion Error 10 Free Records 

72/4 Control Error 10 ( 0:4) = Function 
(4:12) = Paraneter 

72/5 EOF Error 1D Nunber of Records 

72/6 Open Error 10 Nunber of Records 

72/7 Close Free Records at) Nunber of Records 

72/10 Initialization 0 0 ( 0:8) = FN 


( 8:8) = Update 
P4-P6 - Not Used 
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MASTAT Event Group 6 (FILESYS) 


These events are for development use only and are not normally enabled. 


Event -60 (-%74) 

EVENT NAME: FOPEN 
CESCRIPTION: OLD FILE OPEN 
CALLING MODULE: FILERCC 


CALLING PROCEDURE(S): FOPENOR 

Para r_ Description 

P1 = FILE # = (0:2)22 -> Non-Spooler Access 
(0:2). WNE.2 -> 

P2 = AOPTIONS - See Intrinsics Manval 

P3 = File Label FOPTIONS - See Intrinsics flanuel 

P4 = Record Size 


PS = File Label Block Size 
P6 = & OF Buffers 
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Event -61 (-275) 


EVENT NANE: FOPEN’ 
DESCRIPTION: OLD FILE OPEN (CONTINUATION OF EVENT -60) 
CALLING MODULE: FILEACC 


CALLING PROCEOURE(S): FOPENDA 


Paraneter Description 


P1 = File Label File Linit - MSW 
P2 = File Label File Limit - LSU 
P3 = File Label # Of Extents 


P4-P6 - Unused 

Event -60 (-274 

EVENT NAME: FOPEN 

DESCRIPTION: NEW OISC FILE OPEN 
CALLING ACDULE: FILERCC 


CALLING PROCEDURE(S): FOPEN 


Paraneter Description 


P1 = FILE @ = (0:2)22 = Non-Spooler Access 
(0:2). NE. 


2s 
P2 = ROPTIONS - See Intrinsics Manual 
P3 = FOPTIONS - See Intrinsics Manual 
P4 = Record Size 
P5 = Block Size 
P6 = @ Of Buffers 
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EVENT NAME: FURITE 
DESCRIPTION: 
CALLING NODULE: FILEIO 


CALLING PROCEDURE(S): FURITE 


Paraneter Description 


P1 = File # 
P2 = TCOUNT - See Intrirsics Manual 
P3 = FLAGS - (15:1) Buffer Hit Flag 


vent - -7100 
EVENT NANE: FREADDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): FRERDDIR 


Paraneter Descristion 


P1 = File # 

P2 = RCETLOG - Trarefer Count 

P3 = FLAGS - (15:1) Buffer Hit Flag 
P4 = REC # - ASH 

PS = REC # - LSU 

P6 2 Kot Used 
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Event -6! (-%75) 


EVENT NARE: FOPEN’ 
DESCRIPTION: NEW DISC FILE OPEN (CONTINUATION OF EVENT -60) 
CALLING MODULE: FILEACC 


CALLING PROCEDURE(S): FOPEN 


Paraneter Description 


P1 = FCB File Lint 
P2 = FCB Nax # Extents 
P3 = (0:8)= Initial Allocation Extents 


P4-P6 - Not Used 


Event -62 (-Z76 


EVENT WANE: FREAD 
DESCRIPTION: 
CALLING MODULE: FILETO 


CALLING PROCEOURE(S): FREAD 


Paraneter Description 


P1 = File @ 
P2 = ACBTLOG - Transfer Count 
P3 = FLAGS - (15:1) Buffer Hit Flag 
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Event -65 (-%101) 

EVENT WRNE: FURITEDIR 
DESCRIPTION: 

CALLING MODULE: FILEIO 


CALLING PROCEDURE: FURITEDIR 
Paraneter rj 


Pi = File @ 

P2 = TCOUNT - See Intrinsics Ranual 
P3 = FLAGS - (15:1) Buffer Hit Flag 
PQ s REC @ - NSU 

PS = REC # - LSW 

P6 = Not Used 
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Event -66 (-2102) 

EVENT NAME: FUPOATE 
DESCRIPTION: 

CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): FUPORTE 


Paraneter Description 


Pi = File # 

P2 = TCOUNT - See Intrinsics Manual 
P3 = FLAGS - (15:1) Buffer Hit Flag 
P4-P6 - Not Used 


Event -67 (-2103) 

EVENT NAME: IOUAIT 
CESCRIPTIGN: 

CALLING MODULE: FILETO 


CALLING PROCEDURE(S): JOWATT 


Paraneter Description 


Pi = File # 
P2 = ACBTLOG - TRANSFER COUNT 
P3 = FLAGS ~ (15:1) Buffer Hit Flag 
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flASTAT Even up 7 (F 


These events are for developnent use cnly and are not normally ensdled. 


vent -70 (- 
EVENT NAME; FPOINT 
DESCRIPTION: 
CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): FPOINT 


Pi = File # 

P2 = REC @ ~ ASU 
P3 = LSU - LSU 
P4-P6 - Not Used 


Event -71 (-Z107) 


EVENT WANE: FCONTROL 
DESCRIPTION: 

CALLING MODULE: FILEIO 
CALLING PROCEDURE(S): FCONTROL 


Paraneter Description 


Pi = File ®@ 
P2 = Code - See Intrinsics Manual 


P3-P6 - Kot Used 
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ANSTRTS Events 


Event -68 (-2104) 

EVENT WANE: FREROSEEK 
DESCRIPTION: 

CALLING MODULE: FILETO 


CALLING PROCEDURE(S): FRERDSEEK 


Paraneter Description 


Pi = File & 

P2 = FLAGS - (15:1) Buffer Hit Flag 
P3 = REC W - NSW 

P4 = REC @ - LSW 

P5-P6 - Not Used 


Event -69 (-%105) 

EVENT NAME: FSPACE 
DESCRIPTION: 

CALLING MOOULE: FILEIO 


CALLING PROCEDURE(S): FSPACE 


neter ription 


Pi = File @ 


P2 = DISPLACEMENT - See Intrinsics Manual 
P3-P6 - Not Used 


HASTATS Events 


nt 72 (-2714 
EVENT WANE: FSETHODE 
DESCRIPTION: 
CALLING MODULE: FILEIO 


CALLING PROCEOURE(S): FSETHODE 


Par. r rj 


Pt = File @ 
P2 = RODEFLAGS - See Intrinsics Manual 
P3-P6 - Not Used 


Event -74 (-%192) 

EVENT NRE: FCKECK 
DESCRIPTION: 

CALLING NOOULE: FILETO 


CALLING PROCEDURE(S): FCKECK 


P1 = File @ 
P2 = ERRORCODE - See Intrinsice Manual 
P3-P6 - Not Used 
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Event -75 (-Z113) 

EVENT NAME: FGETINFO 
DESCRIPTION: 

CALLING ACDULE: FILEIO 


CALLING PROCEOURE(S): FGETINFO 


Paraneter Description 


Pi = File # 

P2 = FOPTIONS - See Intrinsacs fanual 
P3 = AOPTIONS - See Intrinsics Manual 
P4-P6 - Not Used 


Event -76 (-Z114 


EVENT NANE: FREADLRBEL 
DESCRIPTION: 
CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): 


Paraneter Description 


P1 = File # 
P2 = TCOUNT - See Intrinsics Manual 
P3-P6 - Not Used 
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EVENT NAME: FUNLOCK 
DESCRIPTION: 
CALLING ACDULE: FILEIO 


CALLING PROCEDURE(S): FUNLOCK 


Paraneter Deseription 


Pi = File # 
P2-P6 - Not Used 


FASTAT Event Grou F Y hin 


Event -80 (-2120 

EVENT NAME: FRENANE 
DESCAIFIION: 

CALLING MODULE: FILEACC 


CALLING PROCEDURE(S): FRENANE 


Paraneter Description 


Fi = File ®@ 


P2-F6 - Net Used 
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ANSTATS Events 


MASTATS Events 


RMASTATS Events 


Event -77 (-2115) 


EVENT NAME: FURITELABEL 
DESCRIPTION: 
CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): FURITELABEL 


Paraneter Description 


Pi = File # 
P2 = TCOUNT - See Intrinsics Manual 
P3-P6 - Not Used 


Event -78 (-Z116) 


EVENT NAME: FLOCK 
DESCRIPTION: 
CALLING MODULE: FILEIO 


CALLING PROCEDURE(S): FLOCK 


Paraneter Description 


Pi = File @ 
P2 = LOCKCOND - See Intrinsics Manual 


P3 = COND CODE - See Intrinesics fanual 


G. 23.00 
0-H 

RASTATS Events 

vent -81 (-2Z1 

EVENT NAME: FCLOSE 

CESCRIPTION: 

CRLLING MODULE: FILEACC 

CALLING PROCEDURE(S$): FCLOSE 

Paraneter ription 

Pi = File @ 

P2 = DISP - See Intrinsics nanusl 

P3 = SECCODE 

P4-PG§ - Not Used 

Event 82 (2122) 

EVENT NAME: RUAKEDEV 

DESCRIPTION: AUAKES 1/0 DEVICE MONITOR WHEN SEGMENT FETCH COMPLETES 

CALLING MODULE: KERNELC 


CALLING PROCEDURE(S): PROCESSSCHEDNSG, UNDEF EROBISAPQ 


Paraneter Description 
P1 = SYSOB RELATIVE DIT FOINTER OF LOEV TO 9E RUAKENED 


P2 = WORD O (FLAGS WORD) OF THE O1T OF TmE LDEV TO RE AURKENED 
P3 = IF OATA OBJECT THEN I0Q OR ORQ INDEX OTHERWISE LOEV NUMBER 


P4-P6 - Not Used 
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AASTATS Events 


Event 83 (2123) 
EVENT WARE: STRATEGY 
DESCRIPTION: CALLED 70 OETERNINE THE TYPE OF STRATEGY USED 


CALLING MODULE: 


BASED ON WHO THE CALLER OF COT*ATTACHIO IS 
CACHESEG 


CALLING PROCEOURE(S): CDT’ STRATEGY 


Paraneter Description 


P1 s 
P2 2 
P3 


COT Mapped Donain entry 
LDR Entry Index 


Strategy 
- Unknoun Caller 
1 = Unknoun Fron File Systen 
2 - Speoler 
3. > Directory 
4-7 - Unknown 
8 - GENNESSACE 
9 - File Systen, Quiesce 1/0 
10 - File Systen, Sequential, NOBUF 
11 - File Systen, Direct, NOBUF 
12 - File Systen, Sequential, BUF 
13. - File Systen, Direct, BUF 
14 - File Systen, KSAN 
15 - File Systen, IMAGE 


Pa-P6 - Not Used 
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vent Z1 
EVENT NAME: COT_ATT 
DESCRIPTION: CALLED FROM COT’ATTACHIO 
CALLING MODULE: CACKESEG 


CALLING PROCEDURE(S): COT’ ATTACHIO 


Paraneter Description 


P1 = Ldev 


P2 = Function 


P3 = Flags 


p4-P5 


= Part, Parn2 


P6 = Count 


Event 87 (2127) 


EVENT 


DESCRIPTION: 
CALLING MODULE: 
CALLIVS PROCEOURE: 


WANE: nAP_DON 

CALLED UHEN NEED TO “NAP” A DISC CONAIN 
CACHESEG 

COT’MRP* CACHED’ OCNAIN 


Parareter Dezcription 


P1 = New COT Entry Nunber 


P2 = Returned COT Entry 
P3-P6 - Net Used 


A 
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MASTATS Events 


Event 84 (2124) 

EVENT WANE: INITIATE 

DESCRIPTION: CALLED WHEN STARTING/COMPLETING LOGICAL DISC 
REQUEST 

CALLING MODULE: CRCHESEG 


CALLING PROCEDURE(S): COT’ INITIATOR, COT’CORMPLETOR 


Paraneter Description 


P1 = COT Mapped Oonain Entry Nunber 
P2 = LOR Entry Index 
P3 = Type 


0 = Initiator 
1 - Conpletor 


P4-P6 - Not Used 


Event 85 (7125) 


EVENT NAME: 

DESCRIPTION: 

CALLING MODULE: HRRDRES 
CALLING PROCEDURE(S):  SIODN 
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ANSTATS Events 


ven zi 

EVENT MAME: UN_MAP_RG 

DESCRIPTION: CALLED WHEN DISC COMAIN NO LONGER MAPPED. (I.E., BOTH 
THE LOGICAL AND PHYSICAL I/O IS COMPLETE) 

CALLING MODULE: CACKESEG 

CALLING PROCEDURE: COT’ RAP’ CACHED’ REGION 


Pi = COT Ldev Entry Nunber 
P2 = Region CDOT Entry Nunder 
P3-P6 - Mot Used 


Vv 2131 
EVENT WRHE: LINK_REG 
DESCRIPTION: CALLED WHEN A DISS OONAIN GETS LINKED INTO THE 
LINKED LIST OF NO"AINS FOR AN LOEV 
CALLING MODULE: CACKESEG 


CALLING PROCEDURE: LINK’ CACHED’ REGION, UNLINK’ CACHED’ REGION 


Pareneter Description 
Ps s Type 

0 = Link 

1 © Unlink 


P2,P3 = Addrese Of Region Base 

pa = COT Entry Number Found In The Header 
PS 2 Of Pages 

6 ~ Not Used 
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MNSTATS Events 


MAMSTAT Event Grou ) Requests 
Event 90 (2132 
EVENT NANE: REQCACHE 
DESCRIPTION: CALLED TO SEE IF CRCWING WILL ACCEPT THIS 


1/0 REQUEST 
CALLING MODULE: CACHESEG 
CALLING PROCEDURE: REQUEST’ CRCHE 


Paraneter Description 


Pt = LOR Entry Index 
P2-P6 - Not Used 


Event -98 (-2142) 


EVENT NAME: DISK TRAFFIC 

DESCRIPTION: DISC I/0 REQUEST HAS BEEN QUEUED 
CALLING MODULE: HRRORES 

CALLING PROCEOURE(S): ATTACHIO 


Paraneter Description 


PisCNT Data Transfer Count:Words If >0; 


Bytes If <0 
P2sF LAGS. (0:4) 
P32FNCT sO = Read 
21 = Write 


2 3 Open File 
23 = Close File 
24 = Close Device 
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MASTATS Events 
ANSTRT Even 11 

vent -110 (-Z1 
EVENT NANE: START 1/0 
CESCRIPTION: DRIVER INITIATOR FOR SIO DEVICE HAS BEEN CALLED 
CALLING MODULE: HARORES 


CALLING PROCEDURE(S): SIOON 
raneter Description 


P1 = JOGPL(QSTAT) LOR IOQPL(QLDEV). LOEVN 
= (0:8) PCB Entry # Of Process Making Request 
s (8:8) Logical Device Nunber Of Oevice For 1/0 


P2 = IOQP(QUBCT)eord Count If>0;Byte Count If<0 


P3 = (0:2) = Function Code Specified By Driver 
20 32 Read 
21 2 Urite 
= 2 # Control 
= (6:10)= DSTN Of Target Data Seg 


Event -111 (-Z157) 

EVENT WANE: 1/0 COMPLETION 
DESCRIPTION: SIO COMPLETION 
CALLING MODULE: HARDRES 


CALLING PROCEOURE(S): SIOON 
Paraneter Descri 


P1 = IOQP(QLDEV).LDEVN2Logical Device Nunber Of Disc Involved In Transfer 
P2 = IOQP(QPRR1) - (Defined By Driver) 
P3 = IOQP(QPAR2) - (Defined By Driver) 
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ANSTATS Events 


MASTAT Event Group 10 (Oisc Errors 


Event 100 (2144) 


EVENT NAME: OISK ERROR 
DESCRIPTION: RECORD DISC ERROR 
CALLING ACDULE: IOFOISC1 

CALLING PROCEOURE(S): FHODVR 


Paraneter Description 


P1 = DIPT(DSTAT) - Hardware Status 
P2 = SO - QRISC 
P3 = IOQP(QLDEV).QLDEVN LOR STOCOUNT&LSL(8)) = DEV/SIO Progran Counter 


Event 101 (2145 


EVENT NAME: DISK ERROR 
DESCRIPTION: RECORD DISC ERROR 
CALLING RODULE: IOMOISCO 

CALLING PROCEDURE(S): MHDOVR 


Paraneter Description 


P1 = DIPT(DSTAT) - Hardware Status 
P2 = SO - GAISC 


P3 = TOGP(QLDEV).QLDEVN LOR STOCOUNT&LSL(8)) 
= LDEV/SIO Progran Counter 


6.23.00 
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MASTRT Event Group 12 (Di ace 
Event 120 (2170) 
EVENT NANE: SOFT’ DEATH 
DESCRIPTION: BUG CATCHER 
CALLING MODULE: HRRORES 
CALLING PROCEDURE(S): SOFT’ OERTH 
Paraneter Description 
P1 = SOFT’OERTH I.0. Nunber 
P2 = Caller’s Status Register 
P3 = Caller’s Delta P 
Event 125 (7175) 
EVENT NAME: TOBUFTRP 
EVENT DESCRIPTION: IOSYSTEN BUFFER TRAP 
CALLING MODULE: HRRORES 


CALLING PROCEDURE(S): SION 


Paraneter Description 


Pi = I00P 
P2 = OQ? QOSTN).OSTN = OST Nunber Of Buffer 
PJ = 0 


MASTATS Events 


Event -13 (-2202) 


EVENT WANE: 
DESCRIPTION: 
CALLING MODULE: HARDRES 
CALLING PROCEDURE(S): ATTRCHIO 


Paraneter Description 


Pi = LDEV 

P2 = P Register 
P3 = RSTATUS 
P4-P6 - Not Used 


Event -13! (-2203) 


EVENT NAME: 

DESCRIPTION: 

CALLING ROOULE: HRRORES 
CALLING PROCEOURE(S): ATTACHIO 


Paraneter Description 


P1, P2 = Extent Base 
P3 = Extent Size 
P4-P6 - Not Used 
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ANSTAT Even 4 ise hi 
vent 221 
EVENT MANE: C_RBSENT 
OESCRIPTION: EITHER THE MAPPED OISC DOMAIN OR THE TARGET 
OST UAS RBSENT WHEN A CACHE MOVE WAS ATTENPTED 

CALLING MODULE: CACHESEG 


CALLING PROCEDURE: PROCESSCDT LOGREQQUELE 


Paraneter Description 


La! 20 flapped Donain Absent 

P2 s Pin 

P3,P4 = Segnent Identifier Of Mapped Donain 
P5-P6 - Not Used 


P1 # LOR Entry Index (DST Not Present) 
P2 ® Pin 


P3,P4 = Segnent Identifier Of DST (P4.(0:1) = 1 Stack) 
PS5-P6 - Not Used 
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ANSTATS Events 


Event -132 (-2204) 


EVENT WANE: 

DESCRIPTION: 

CALLING RODULE: HARORES 
CALLING PROCEOURE: ATTACHIO 


Paraneter Description 


P1, P2 = Fornal Parameters Given To ATTRCHIO Which Are Device 
Dependent Paraneters 


P3 = Fornal.FLAGS Paraneter Supplied To ATTACHIO By The Caller 
P4-P6 - Not Used 
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MASTATS Events 


HASTAT Ev 14 


Event 140 (%214) 


EVENT NAME: COPEN 
DESCRIPTION: 

CALLING MOOULE: CONSYS2 
CALLING PROCEDURE(S): COPEN 


Paraneter rioti 
P1 = (0:8) = CS Error Code 
s (8:8) = Logical Device Nunber 
P2 = PHRPI 
P3 = PHAPZ 


Event 142 (2216) 


EVENT NARE: CABORTIO 
DESCRIPTION: 

CALLING MODULE: COnSYS1 
CALLING PROCEOURE(S): CABORTIO 


Paraneter Description 


P1 = Logical Device Nunber 
P2 = IGGINDEX 
P32 0 
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AASTATS Events 


Event 144 (2220) 

EVENT NANE: CSIGUAIT 
DESCRIPTION: 

CALLING MOOULE: CONSYS1 


CALLING PROCEDURE(S): CSIOWAIT 


Paraneter Description 


P1 = (0:8) = CS Error Code 
= (8:8) © Logical Device Nunber 


P2 = Transnission Log 


P3 

Event 146 (2222) 

EVENT NAME: CCLOSE 
DESCRIPTION: 

CALLING MODULE: CONSYS3 


CALLING PROCEDURE(S): CCLOSE 
Paraneter Descripti 


Pi (0:8) = CS Error Code 
(8:8) # Logical Device Nunber 


P2 = Line Nunder 
P3 = 0 
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MNSTATS Events 
fINSTAT Event Group 15 (CS/3000) 

Event 150 (2226) 
EVENT NAME: CSDRIVER 
CESCRIPTION: 
CALLING MOOULE: BSCLER 


CALLING PROCEDURE(S): CSORIVER 


Paraneter Description 


Pi s TIMER - LSW 
P2 = CURRENTSTATE - Where The Oriver Is In The State Transition Table 
P3 = CURRENTEVENT - (0:8) = Current Event 


(8:8) = Logical Device That Caused The Driver To 
Becone Rctive 


Event 152 (2230) 

EVENT WANE: CCONTROL 
DESCRIPTION 

CALLING ROOULE: consyss 


CALLING PROCEOURE(S): CCONTROL 


Parameter Description 


P1 = (0:8) = CS Error Code 
= (8:8) © Logical Device Nunber 
P2 = Control Code 


P3 = Paraneter 


6.23.00 
20- 51 


MASTATS Events 


Event 147 (223) 


EVENT WARE: CRERD 
DESCRIPTION: 
CALLING MODULE: CONSYS4 


CALLING PROCEDURE(S): CREROD 


Paraneter Description 


P1 = (0:8) = CS Error Code 
(8:8) = Logical Devace Nunber 


P2 = INCOUNT 
P3 = STATION 


Event 149 (2225) 

EVENT NAME: CURITE 
DESCRIPTION: 

CALLING RODULE: CONSYS4 


CALLING PROCEDURE(S): CWRITE 
Paraneter Descriotion 


Pi = (0:8) = CS Error Code 
= (8:8) = Logical Device Nunber 
P2 = OUTCOUNT 


P3 = INCOUNT 
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Event 153 (2231) 
EVENT KANE: COPENTRACEFILE 


DESCRIPTION: 
CALLING MODULE: 
CALLING PROCEOURE(S): COPENTRACEFILE 


Paraneter Description 
P1 = (0:8) = CS Error Code 
= (8:8) = Logical Device Nunber 


P2 = CTRACEINFO 
P3 20 


Event 154 (7232) 


EVENT NRME: CCLOSE TRRCEFILE 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEDURE(S): CCLOSETRACEFILE 


P1 = CS Error Cede 


= (0:8) 

= (8:8) = Logical Device Nunber 
P2 #0 

P3 #0 
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HASTATS Events 


Event 155 (2233) 


EVENT WANE: CPOLLIST 
DESCRIPTION: 

CALLING MODULE: 

CALLING PROCEOURE(S): CPOLLIST 


Paraneter ription 


P1 = Logical Device 
P2 = CS Error Code 


P3 = PRAP 

6.23.00 
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MASTATS Events 
TAT Ev 4 i n etn 
Event 191 (2277) 
EVENT NAME: DISKINTRPT 
OESCRIPTION: A 7905/7920 CONTROLLER IS PROCESSING RW ATTENTION 
INTERRUPT (ONLINE /OFF LINE) 

CALLING MODULE: HARORES 


CALLING PROCEDURE(S): SIODA 


Paraneter ri 


P1 = @DITP - (US) - (i.e., Who Got The Interrupt) 

P2 = @DITP - (THEN) - (i.e., Who Ren The Poll Progran) 

P3 = DITP - “OUR” DIT Flags Word 

H aingle iasloves (nrtue): apeest Will guvaraterst Ient 


2303, 2300, 2303. If the queue of I0Q’S on a DIT never enpties, 
there would be one 2300 and one 2303 per SIO PRON. 
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AASTATS Events 


AASTAT Event Group 16 (€$/3000 


Event 160 (7240) 

EVENT WANE: CREAD 
DESCRIPTION: 

CALLING MODULE: OSNON 


CALLING PROCEDURE(S): 


Paraneter Description 


Pi = Tine Stanp 


P2 = (0:4) Not Used 
(4:1) Block 
(5:2) State 
(7:3) Next 
(10:1) :#0 Initialization Event 
221 Conpletion Event 
(11:5) Sub Event Nunber 


P3 = Depends On The Sub Event Nunber Rnd 
If It Is An Initialization Or Conpletion Event 
MSG: (0:4) STRITYPX 


(4:6) MSG CLS 
(10:16) STRATYP 
SUB EVENT SUB EVENT INIT 
2 NANE PARN 
0 CREAD 0 
CURITE x ASG 
2 IOWAIT 0 
3 CCHECK 0 
4 OSATTN 0 
5 OSUC xX ASG 
6 CHNGEWATT PARK 
7 NONREQ REQ 
10 CABORT 0 
11 CRESET 0 
12 CSDATA R ASG 
13 CSRERERD 
6.23.00 
2d- 
MASTATS Events 
Event 192 (7300) 
EVENT RANE: GIPINTERRUPT 
DESCRIPTION: INTERRUPT JUST PROCESSED 
CALLING MODULE: HARDRES 


CALLING PROCEDURE(S): GIP 
Paraneter ription 


Pi = LOEV 

P2 # Queue Elenent Word Entry Index 

P3 = Contents Of DIT Word O: The Flags Word 
P4 = Channel Progran Instruction Pointer 

PS = Controller Status 

P6 = LS of a Return fron TIMER 


Event 193 (2301) 

EVENT WANE: STRRTIO 

DESCRIPTION: ISSUING SICP ARCHINE INSTRUCTION 
CALLING MODULE: HARORES 


CALLING PROCEDURE(S): STRRT’HPIB, STARTIO 
Paraeter Description 


P1 = Absolute Address Of SIO Progran To Start 
P2 = LOEV Nutber 

P3 2 DRT Nunber 

F4 = Q’ENTRY INDEX Fron DITP(DIOGP) 

PS © DIT Word 0: ~=The DIT Flags Word 

P6 = LSU Of A Return Fron A Call To TIMER 
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RAASTATS Events 


Event 194 (2302) 


EVENT NANE: SICDA-ENTRY 
DESCRIPTION: ENTERING SIODNA 
CALLING MODULE: HARDRES 


CALLING PROCEDURE(S): SIOON 


Paraneter Description 


P1 = LDEV 

P2 = J0Q OR ORQ Table Relative Index 

P3 = DIT Word O (DIT FLAGS) 

P4 = Current State Of The Variable State In SIOON 
PS = Not Used 

P6 = LSU Returned By Cail To TIMER 


Event 195 (2303) 


EVENT NAME: SIOON-EXIT 
DESCRIPTION: LERVING SIODN MAIN LOOP 
CALLING ACDULE: KARORES 


CALLING PROCEOURE(S): SIOON 


Paraneter Description 


The sane as Event 194 (2302), absve. 
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Event 201 (2311) 
EVENT NAME: DISKBUGCATCHER 
DESCRIPTION: A PRIVATE VOLUME USER TRBLE CHANGE IS BEING RADE. 


CALLING RODULE: PYSYS 
CALLING PROCEDURE(S): USERTRBLE 


Paraneter Description 


P1 = FUNCT 
0 = Create User Entry 
1 = Renane User Ertry ° 
2 = Return fll MVIABX Ind.ces Used By A 
Specific PCB 
3 = Return All PCB Pointers Using A Specific 
MV TABX 
4 = Get User Entry 


P2 = MVTABX (Mounted Volune Table Index) 
P3 = DELTAP (Value Of 9-2) 


ANSTAT Event “coup 21 





Event -211 (-Z222 


EVENT NSE: PROCESS COMPLETION 
DESCEZFTION: PROCESS HAS TERMINATED 
CALLING "ODULE: MORGUE 


CALLINS FROCEDURE(S): TERMINATE 


Farareter Cescription 


P12 0 

P2. = 0 

P20 
5.23.00 
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MASTATS Events 


MMSTAT Event Group 20_ (Private Volunes) 


These Events are for developnent use cnly and are not normally enabled. 


Event 200 (2310) 

EVENT NAME: OISKBUGCATCHER 

DESCRIPTION: A MOUNTED VOLUNE TABLE CHANGE IS BEING MADE. 
CALLING MODULE: PvSYS 


CALLING PROCEDURE(S): MVTABLE 


Paraneter Description 


P1 = FUNCT 
O = Delete Entry 
1 = Add Entry 
2 = Preserve Entry 
P2 = MVTABX (Mounted Volune Table Index) 


P3 = DELTAP (Value Of Q-2) 
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MMSTATS Events 


ANSTAT Event Group 22 (Monitor Config Information 


ven 1 (2335 

EVENT WANE: CONFIGURATIGN INFORNATION 
DESCRIPTION: EVENT GROUP MASK 

CALLING NODULE: CRIO 


CALLING PROCEDURE(S): CONSMON 


Paraneter Description 


P1 = RERSASKO 
P2 = AEASASKI 


P3 = Reserved 


ee LTA SSN ng SS yw ES ew eS PASSA 


Te ae ee 


AASTATS Events 


ven z 

EVENT NAME: CONFIGURATION INFORMATION 
CESCRIPTION: MPE VERSION FIX UPDATE 
CALLING MODULE: OPCOMMAND 


CALLING PROCEDURE(S): CXMON 


Paraneter Description 


Pi = Version 
P2 = FIXL 
P3 = UPORTEL 


Event -223 (-%337) 

EVENT WARE: CONFIGURATION INFORMATION 

DESCRIPTION: SYSTEN TABLE LOCATIONS AND AVAILABLE LINKED MEMORY 
INFORMATION 

CALLING RODULE: OPCONMAND 


CALLING PROCEDURE(S): CXRON 


Paraneter Description 


P1 = F (Z1032)=@CST(0)-@DST(0) =Displacenent To Code 
P2 = F(Z1033)=@CST(LAST)-@D0ST(0) =Displacenent To Sharable 
P3 = LOGICAL(TOTALSDLSK(4))2Linked Nenory Size 
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MASTATS Events 
vent - J 
EVENT NAME: SYSPINS(CNTO. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 
CALLING MODULE: OPCONNANO 


CALLING PROCEDURE(S): CXNON 
raneter rj 


P1 = RBSOLUTE(Z1147)=STNSG’S PCB Entry Nunber 
P2 = ABSOLUTE(Z1150)=LOG’S PCB Entry Nunber 
P3 = ABSOLUTE(Z1151)=LOAD’S PCB Entry Nunber 


Event -227 (-2343) 

EVENT NAME: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 
CALLING NODULE: OPCONNAND 


CRLLING PROCEDUPE(S): CXnON 
Paraneter Deseription 


P1 = ABSC.UTE(Z11S2)2IGNESSPROC’S PCB Entry Nunber 
P2 = ABSCLUTE(Z1°53)=SYSIOPROC’S PCE Entry Nunber 
P3 = ABSCLYTE(Z11546)=MENLGGP’S PCB Entry Nunber 
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AASTATS Events 


vent -224 {-2340 


EVENT WARE: SYSPINS 
DESCRIPTION: LOGICAL PROCESS TABLE 
CALLING MODULE: OPCOMNAND 


CALLING PROCEDURE(S): CXMON 


Paraneter Description 


P1 = RBSOLUTE(Z1141)sPROGEN’S PCB Entry Nunber 
P2 = ABSOLUTE(Z1142)=NAN'S PCB Entry Nunber 
P3 = ABSOLUTE(Z1143)=UCOP’S PCB Entry Nunber 


vent -225 (-2341 


EVENT NARE: SYSPINS(CNTD. ) 
DESCRIPTION: LOGICAL PROCESS TABLE 
CALLING MODULE: OPCONMAND 


CALLING PROCEDURE(S): CXMON 
Paraneter Descri 


P1 = ABSOLUTE(Z1144)=PFAIL’S PCB Entry Nunber 
P2 = ABSOLUTE(Z1145)=DEVREC’S PCB Entry Nunbder 
PJ = ABSOLUTE(Z1146)=PRNSG’S PCB Entry Nunber 
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RASTATS Events 


vent - -% 
EVENT NRME: TINESTRAP 
OESCRIPTION: TINESTANP 
CALLING MODULE: OPCONMANO 


CALLING PROCEDURE(S): CXMON 
Paraneter Description 
P1sCALENDAR (0:7) = Year Of Century 


(7:9) = Day Of Year 


P2sCLOCK(NORD1). (0:7) © Hour Of Day 
(8:8) = Minute Of Hour 


P3xCLOCK(WORD2). (0:7) © Seconds Into Rinute 
. (8:8) = Tenths Of Seconds 


v - -% 
EVENT MANE: nONOFF 
DESCRIPTION: END EVENT TRACING 
CALLING MODULE: OPCORMAND 


CRLLING PROCEDURE(S): CXMON 
Paraneter r. 


Pi = 0 
P2 #0 
P32 0 





ANSTATS Events NASTATS Events 


fINSTAT Event Group 23 (Ternjnal 1/0) Event 232 (7350) 
Event 2% (2346) EVENT NAME: TERMURITE 
DESCRIPTION: WRITE COMPLETION 
ANE: TERNREAD 
ees CALLING MODULE: IOTERMO 
DESCRIPTION: TERMINAL READ COMPLETION 





CALLING PROCEOURE(S): TERIOR 


CALLING MODULE: HARDRES 
CALLING PROCEOURE(S): TIP Paraneter Description 
Paraneter Description Pi = LDEV 
P2 = 0 
Pi = LDEV 


P3 = Byte Count Of Transfer 
P2 = Read Duration 


P3 = Bytes Read 
Event 233 (£351) 


Event 231 (2347) EVENT NAME: BINRERD 
DESCRIPTION: BINARY RERD COMPLETED 
EVENT NAME: OC1OC2ACK 
CALLING MODULE: HARDRES 
DESCRIPTION: 0C1/0C2 HAS BEEN SATISFIED CALLING PROCEDURE(S): TIP 
CALLING MOOULE: HARDRES 


Paraneter Description 
CALLING PROCEDURE(S): TIP 


Pi = LDEV 
Paraneter Description 
P2 = Duration 
Pi = LEV P3 = Bytes Read 
P2 = Duration (Betueen Start And 0C2) 


PJ = Bytes Read (Excluding C2) 
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MASTATS Events ANSTATS Events 
Event 234 (2352) Event 236 (Z354) 
EVENT NRIE: TERNLOGON EVENT NAME: SPECCHAR 
DESCRIPTION: TERMINAL JUST LOGGING ON DESCRIPTION: PROCESSED SPECIAL CHARACTER 
CALLING MODULE: TOTERAO CALLING NODULE: HARORES 
CALLING PROCEDURE(S): TERNION CALLING PROCEOURE(S): TIP 
Paraneter ripti Paraneter Description 
Pi = UWEV Pi = LDEV 
P2 = 0 P2 = Special Character Processed 
P32 0 P3 = 0 
ven Zz Event 237 (2355) 
EVENT NAME: TERNLOGOFF EVENT NAME: BRERK 
DESCRIPTION: TERMINAL JUST LOGGED OFF DESCRIPTION: PROCESSED BREAK 
CALLING MODULE: IOTERNO CALLING NODULE: HARDRES 
CALLING PROCEDURE(S): TERNICH CALLING PROCEOURE(S): TIP 
Paraneter Deser, n rareter eristion 
P1 = LOEV Pi = DEV 
P2 20 P2 = OSTATE 
P32 0 P3290 
6.23.00 6.23.00 


20- 67 <o- 68 


soe tye D 


ANSTATS Events MASTATS Events 





vent 238 (235 ANSTAT Event Group 24 (Power Fai 
EVENT NAME: SPECRERD Event 240 (7360) 
CESCRIPTION: SPECIAL READ TERMINATION CHARACTER DETECTED 
EVENT NAME: PFAIL 
CALLING MODULE: HRRDRES 
DESCRIPTION: POWER FAIL DETECTED 
CALLING PROCEDURE(S): TIP 
CALLING MODULE: ININ, PFAIL 
Paraneter Description CALLING PROCEDURE(S): POWERUP (ININ), POWERUP (PFAIL) 
Pi = LDEV Paraneter Description 


P2 = Ourataen 
P1206 Called Fron Pouerup In ININ 
P3 = BCNT 1 Called Fron Entry In Powerup In PFAIL 
2 Called Fron End Of Powerup In PFAIL 


P 2 For Pix0 This Is 0 
For P121,2: 
TRUE = Multiple Powerfail 
FALSE2 First Powerfail 


P3 = PF 

0 = No Powerfail Or PFAIL Processing Conplete 

1 = Set By The Power Down Trap In ININ 

2 = Set By The Power Up Trap In ININ 

3 2 Set When Ruake The PFAIL Process 
4 = Set By PFAIL After Neesage Rppears On Console 
$ 


YSUP 
0 © Systen Not Back Up After Pouerfail 
1 s Syeten Back Up After Pouerfail 


P5-P6 - Not Used 


Pa « 
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20- 69 2- 70 
MASTATS Events Rootfile Layout 
Event -241 (-%361) CHAPTER 21 ROOTFI yout 
EVENT WARE: PSEUDOINT General Rootfile Layout 
DESCRIPTION: PSEUDO/SOFT INTERRUPT HANDLING ' 
CALLING NODULE: MISCSEGC | | 
LABEL 0} ROOTFILE INFORMATION | 
CALLING PROCEDURE(S): PSUEDOINT (128 WORDS) ! 
| | 
Paraneter Description " PASSUGRO TABLE 
: | | 
P1 = Interrupt Type 2] PASSUORD TRBLE (CONT.) | 
= © If Hard Kill (P2, P3 Not Used) | | 
21 If Soft Kill (P2, P3 Not Used)  [etecaceateteneteteterenstetatatatetenanetae | 
= 2 If Control-¥ (P2, P3 Not Used) | | 
= 3 If Break (P2, P3 Not Used) 3] ITEM R/W TABLE | 
= 4 If Systen Soft Interrupt | | 
P2 2 | poccer en cnewwecoennsowen | 
P3 8 es s 
= 5 If User Soft Interrupt 3 . 
P2 ; 
P3 = ee 
P2, P3 = Dependent on PI .| SET R/U TRBLE 


| 

| 

P4, PS, P6 - Not Used 

RECORD 0| DATABASE GLOBAL INFO 
| (128 wORDS) 


[ 
1| ITER MAP 
| SET MAP 


| 9882 OSCOC8 COST SFESOESS SFOS | 


| 
2| ITEM TABLE 
. | (VARIABLE SIZE) 





.| SET TABLE | 
"| (WARIQBLE SIZE) | 
| DATA SET CONTROL BLOCKS] 
| (DSCB) 
ol | 
| { 


(VARIABLE $17°) 


"| OCVTCE CLASS TRELE =| 


; | (VARIAGLE S$i2E) ! 
" |eeeeeenenncennnenaneene- 
6.23.00 
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a EPA EAT TT 











Rootfile Layout 


The data base ROOT FILE is an MPE file wath filecode equal to -400. The 
record size 18 128 words, faxed, binary format with a blocking factor of 1. 
The suze cf the file depends on the nunber of data itens and data sets 
defined in the data base. 


Root File Label 0 
| O| RL°CONDITION - (ROOTFILE CONDITION) [0 
| 1{ RLU'DATE - | (CREATION DATE) \1 
| 2] RLU'TINE > (CREATION TIME) \2 
| 

See Seon PAE OOS OPO @ BC BOBS OBSOSSSSSSSSSSEOSOO | 
| 4| RL’ EVEROPEN 14 
| 5] RL'COLDLOADIO - (COLD LOAD 1D) 5 
| 6] RL USERCOUNT [6 
| u RL'DBG'NUN = >: (OBG_ DST NUNBER) \7 
| 10| RL'LOGID = - (LOG IO FOR \8 
| 11| TRANSACTION LOGGING) {9 
| 12] [10 
| 13] [11 
| 14] RL’LOGPASS = - (LOG ID PASSWORD) \12 
| 15] \13 
| 16| \14 
| " 115 
| 20] RL’FLAGS - (ORTABASE FUNGS) 116 
| 21| RL'STORDATE - (DBSTORE OATE) 17 
| 22| RL’ STORTINE (DBSTORE TINE) {18 


| 
| 24] RL’B BUF SPECCOUNT (BUFFER SPEC COUNT) {20 


6.23.00 
21- 2 


Reotfile Layout 
Root Fi ont. 


RL’CONDITION (IN ASCII): 

J8 - Virgin. The database has not been created yet. 

FU - OK. The database is OK. 

Ri - Modified deferred. The database is being nodified. 

MC - Maintenance create. The database is being created. 

NE - flaintenance erase. The database is being erased. 

IL - ILR recovery in progress. 

IE - ILR enable in progress. 

ID - ILR disable in progress. 

CN - Conversion by D8CONV was in progress and cannot be 
continued. 

CA - Conversion by DBCOMY was in progress and can be 
continued. 

IV - Database file move is in progress. 


RL’ORTE - Root file creation date*. The fornat is: 
1 2 4567 8 
fader dete fede feedlot 
| | YEAR 


RL’ TIME - Root file creation tine*. The fornat is: 


0 4 9012 
| HOU | MINUTES | 
j SELEWOS | TENTH OF SECONDS | 


| SS SOOO CSSSSOSOGGOOSTOSTS | Saeeene eeoers corearseeeeo 


RLEVEROPEN - This field is no longer used under IMAGE B 


RL’ FLAGS - 

(0:1) = RECOVERY Default is NO (0) 
(1:1) - LOGGING Default is NO (0) 
(2:1) - ACCESS Default is YES (1) 
(3:1) - OUNPING Default is NO (0) 
(4:1) - OUTPUT DEFER Default is NO (0) 
(5:2) - SUBSYSTEM ACCESS Default is R/U (00) 
(7:1) - IR Default is NO (0) 
(8:1) - ROLLBANK Default is NO (0) 
(9:1) - RESERVED 

(10:1)- DIRTY FLAG Default is YES (1). 


This indicates the database has 
been nodified but not DBSTOREd. 
(11:1)- OBRECOV RESTART Oefault is NO (0) 
(12:4)- RESERVED 


6.23.00 
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Rootfile Layout 


Root File Label 0 (Cont. 


| 
| 31] RL'ILRLASTTIME (LAST LOG ACCESS TIME) {25 
| 32| |26 
| 33] RL'RBPREOATE (PREVIOUS ROLLBACK OATE) (27 
| 34| RL'RBPRETINE (PREVIOUS ROLLBACK TIME) 128 


| 35| |29 
| el acaaonte Gatlaee wate) 
pl caine tte 
a: ee [3 
eel Rome enc To) 


43] RL’ LANG’ MNERONIC (LANGUAGE FINEMONIC) 135 


$2] ‘A 
| 53| RESERVED duck DBCONV fig 
54| RESERVED \44 
| 7 FUTURE = 
| 77| © 
| 100| RL’ RAINTWORD (DATABASE MAINTENANCE 164 
| 101 WORD) |65 
| 102| 166 
| 103] \67 


104] RL’ BUFFERSPECS (BUFFER SPECIFICATIONS) |68 


177| {127 
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Rootfile Layout 
Root File Lab C 


RL'STORDATE - Sane fornat as RL'OATE*. 

RL’STORTINE - Sane format as RL’ TINE*. 

RL’BUFSPECCOUNT - Maxinun nunder of buffer specifications allowed. 
RL'ILRCREATEDATE - Sane fornat as RL’ DATE*. 

RL'ILRCREATETINE - Sane format as RL’ TINE*. 

RL'ILRLASTDATE - Sane format as RL'DATES. 

RL’ ILRLASTTINE - Sane format as RL’ TIMES. 

RL'RBPREDATE ~ Sane fornat as RL'OATE*. 

RL’ RBPRETINE - Sane format as RL’ TINE*. 

RL’RBDATE - Sane fornat as RL’DATE*. 

RL'RETINE - Sane format as RL’ TIAE*. 

RL’ LANGUAGE’ ID - Sane fornat ae defined in systen configuration. 


RL’ LANG’ NNENONIC - Language nnenonic for this database. 
Maxanun 16 characters. 


RL’MAINTWORD - For data bases with no maintenance uord this field has 
2 senicolons (’;;') and trailing blanks. 


RL'BUFFSPECS - 

| 0123 45 6 7 8 9 10 11 12 13 14 15 

| goal aberdas'roua usta | lourrens ror’'2 users Jos 
| at re rs Rare sf 


| | 
1271 BUFFERS FOR 119 USERS joebda FOR 120 USERS [177 


® The DATE and TINE fields can be formatted (for display purposes) 
individually by calling the FNTCALENDAR and FATCLOCK Intrinsics 
respectively, or both fields can be formatted at once uith FATOATE 
intrinsic. 


6.23.00 
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Reotfile Laycut 
R Fi adels 1 


Label {1 


onnn-nnnnonsnonnnnnnenneneennnnnneneenee |Z 


UORD O] PASSWORD FOR USER CLASS 0 10 
4| (THIS IS A OUNAY FIELD SINCE USER 1 


2| CLASS O IS NOT DEFINED) j2 
3| fy 
4| PASSUORD FOR USER CLASS 1 /4 
sI 15 
6| 16 
7| ” 
} 10} PASSWORD FOR USER CLASS 2 \8 
| 11] 19 
{ 12] 110 
| 13] j11 
areata eae | 
eaeweacewcccaseecnceeneaseococacnoces coowe| 
| 174| PASSWORD FOR USER CLASS 31 1124 
| 1 1125 
| 176] 1126 
| 177| |127 
| prnnnewe woe n nw non enenewowonnneroenwnnwn | 
6.23.00 
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Rootfile Layout 


Root File Label 3 

| --n--n--n--2nevennnennvonoenennennaenne| 

| a ITEM! RERD/URITE BIT RRP ie 
2| {2 
3} 13 
4| 14 
§| 15 
6] 16 
a : 

| 10| ITEM2 READ/WRITE BIT MAP 18 

| 11] : 9 

3 

| 

| ut ye 

| 20] ITEMS RERD/WRITE BIT MAP 116 

| 21| 41? 

@ ao 

| a ae 

| 170| ITEN16 READ/WRITE BIT NAP {120 

| 171) {121 

= : 

| 177| 1127 








| ep a eh pce ae td epee } 


The Iten Read/Write Table starts in user label 83. There are eight uords for 
each Iten Read/Urite bit nap. For databases with nore than 16 itens, the 
Read/Write table continues in the next user labels. The specific format of 
this table is explained after the Set Read/Urite Tabie since it is defined 
the sane uay. The nunber of user labels occupied by the Iten Read/Jrate 
Table depends on the nunber of data itens defined in the schena and can be 
obtained by rounding upwards (ceiling)the result of: 


Nun-of-labels = [(Kun-of-itens)*8)/128 


Since there can only be a naxinun of 1023 data itens in the schena, the naxi- 
nun size for this table in user labels uould be: 


Max-size = [(1023)*8)/128 = 63.93 => 64 labels. 


Rootfile Layout 


abe 
| --ncnnnnnnnnnnnnconcenn ene nennnecnnonne Iz 
WORD O| PASSUORD FOR USER CLASS 32 4 
1| 
2] \2 
| : 
4| PASSWORD FOR USER CLASS 33 f 
5| 
6] \6 
a 2 
| M1 PASSWORD FOR USER CLASS 34 £ 
| 1 
| 12 {10 
| 13} |" 
[-enneneennnennnnncnnncnncennnnnnnnconee| 
| = a 
| | 
| 174] PASSWORD FOR USER CLASS 63 1124 
| 175] J125 
| 176| 1126 
| 177| {127 


The Password Table occupies user labels number 1 and 2. There are four uords 
(8 characters) reserved for each passuord. The relative position of 2 pass- 
word corresponds to the user class nunber defined in the schena. For user 
class nunbers not defined in the SCHEMA, the four word field is filled with 
blanks. 


6.23.00 
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Rootfile Layout 
R ile - Next La 
| | -rowen wren nnn econee--o- seceececncenene= | 
| 4 SET1 RERD/URITE BIT MAP io 
1 1 
2| \2 
3} 13 
aj 14 
S| /s 
6| 16 
7 \7 
{ 10| SET2 READ/URITE BIT NAP \8 
\ 11) \9 
| : _ 
| 
| 17| 15 
| 20| SET3 READ/URITE BIT RAP \16 
| | 7 
a i 
i ly i 
{ 170] SET16 RERD/WRITE BIT NAP 1120 
{ 171] [121 
a 
| m7) pe 


The Set Read/urite Table starts cn a user label boundary after the Iten 
Read/Urite Table. There are eight words for each Set Read/Write bit nap. 
For databases with nore than ‘6 data sets, the read/urite table continues in 
the next user labels. The specific fornat of thie table is shown on the next 
page. 

The nunter of user labels occupied by the Set Read/Write Table depends on the 
nunber of data sets defined in the schena, and is obtained by rounding up- 
wards (ceiling) the result of: 

Nun-of-Jabels = [(Nun-of-sets)*8}/128 


Since there can only be a maxinun of 199 data sete defined in the schena the 
maxinun size for this table in user labels is: 


Max-size 2 ((195,*8)/128 = 12.44 s 13 labele 
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Rootfile Layout 
Root File - Next Label(s) (Cont. 


Iten/Set Read/Write Table Fornat 


There are eight words per iten/set Read/Urite Table definition and up to 16 
itens/sets per record (user label). Wathin each 8 uords, the first 4 uords 
are the flags for the user classes uhich have read access to the iten/set. 
The second 4 words are the flags for the user classes which have urite access 
to the iten/set. The detail fornat for an eight word field is shown below. 


1. Four words for read access: 


| 
| WORD 1 | WORD 2 | WORD 3 | WORD 4 | 


| See Ges o8e OG | enw cen enn non eene J enemo nnn nnnnneee | 2e2en2 een eneeeoee | 


Four uords represent 64 bits. 61t n represents read access for user class 
n to the iten/set. If bat nis set to 1 then user class n has read access 
to the iten/set. For exanple, if the word settings are: 


word 1 WORD 2 WORD 3 WORD 4 
2000016 2020000 2000410 2001300 


This neans that user classes 12, 13, 14, 18, 39, 44, 54, 56 and 57 have 
read access to the iten/set. If no read/urite security is defined at all 
for the iten/set, then all of the read security bits are set to 1. 


2. Four words for write access: 


Urite access flags have the sane format as the read access flags. Bit a 
represents urite access for user class n to the iten/set. If bit n is set 
to 1, then user class n has write access to the iten/set. For exanple, if 
the word settings are: 


WORD 1 «WORD 2 WORD 3 WORD 4 
2000010 020000 000000 %001100 


This neans that the user classes 12, 18, 54 and 57 have write access to 
the iten/set. If no read/urite security 18 defined at all for the 
iten/set, then all of the urite security bits are set to 0. 


6.23.00 
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Rootfile Layout 
Root File Record 0 (Cont. 
| concern nnn nn ewe wenn nnn ewe we nen ennwwneronoce scone | 
| 35| RE’ RESTART’ FGROUP |29 
| 36] {30 
| 37| |31 
| ~ - 
| 41| RR'RESTART’ FACCT [33 
| 42 (34 
| 43| 135 
{ 44| |36 
| 45] RESERVE |37 
7 (SET TO BINARY 0°S) a 
| a ee ee ee eee 8 


ROOST’ DBSTATUS 

(0:8) - INAGE version (‘C* in ASCII) 

(8:8) - Binary 2 (filler) 
ROOT’ DBNANE - DATABASE nane left justified (last 2 chars are blank). 
NOWOPEN - Nunber of data sets opened. This field is not used in IMAGE Ba. 


NAXOPEN - Maxinun nunber of data sets that can be opened. This field is 
not used in IMAGE B & C. 


ROOT’ DSGFLAG - 1: Infornation can fit in 086. 
0: Infornation can not fit in DBG. 


RR‘RESTART’FNANE - Restart file rane for DBRECOV stop/restart. 


6.23.W 
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Rootfile Layout 


Root File Record 0 


| 0| ROOT’ OBSTATUS . 
| ecw ee cee we ce cc ees sceweewsrsces sos cesessasesnoere 
1| ROOT’ DBNANE 4 
2| \2 
3 {3 
4| : 
§| ROOT’TRLRLGTH (TRAILER AREA LENGTH) : 
6] ROOT’BUFFLGTH (BUFFER LENGTH) : 
| aeccenenneneennernnnncenanenewennnnewennaneenene 
7| ROOT’ LGTH (ROOTFILE LENGTH) |7 
| mt is 
| 11| ROOT’ ITERCT (NUMBER OF ITENS) 7 
| 12| ROOT’ SETCT (NUNBER OF DATA SETS) Pe 
| 43] ROOT’ ITEAMPTR (RECORD @ OF ITEM TRBLE) \11 
| 14] ROOT*OSETPTR (RECORD ® OF SET TABLE) |12 
| 15] ROOT‘OSCBPTR (RECORD # OF DSCB’S) \13 
| 16| ROOT DEVICEPTR (RECORD # OF DEVICE CLASS TABLE) |14 
| ae ROOT’ DBGF LAG i 
| 20| RESERVED (SET TO BLANKS) 116 
| 2t| \17 
] 22| ]18 
| fa 
| a NOWOPEN ha 
| 25| MAXOPEN \21 
| as PR’ RESTART’ CALENDAR 4 
{ 27| RR’ RESTART’ TIMESTAMP {23 
| K+] | 24 
| 31} RR’ RESTART’ FNANE 125 
| 32] \26 
| 33} j2? 
| | {28 
| ---nennwanenenonnnnnnnnnnewnonnnnnnsenncenennene| 
6.23.00 
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Rootfile Layout 
Root File Record 1 


012 3 4 if s 7 8 9 10 1% 12 13 14 15 


| 
I o| 
1| \1 
! ~ ITEn ARP y 
| 36| 130 
| ot a: 
4©| RESERVED FOR FUTURE USE 132 
41| 133 
| : 
| 
| 76) 162 
| m ae 
| 100] 164 
| 101] 165 
* SET RAP : 
| = 136| |94 
| my ie 
| 140| RESERVED FOR FUTURE USE |96 
| 141] \97 
- > 
| 176| 1126 
| 177] \127 


| 0980908 C 008806698200 O8E08 28S 2SE88 G2 SESOSSTESSEOSOSO | 


The Iten Nap occupies Words 0-31. 
The Set flap occupies Words 64-95. 


These tuo maps are used by OBOPEN for faster access to information in the 
Iten Table and Set Table. 


6.23.00 
2t- 13 





Rootfile Layout 


R File Record 


| 6041234 8 6 7? 8 91011 12 13 14 15 
de el i ae a eel--l--] 
| 0} ITEN NAME 1 10 
1] 1 
2| {2 
3| 13 
4| 14 
5| \s 
6] 16 
7| 4 
| 10| ITEN KO. OF oe ls 
| eee wecnw ewes es ceenace | coweeceunews senses aneoons 
| 11] RESERVEO 1 | RESERVED 2 \9 
| 12] ITEM TYPE SUBITEN COUNT 110 
| wecescece cnsnccwcsscece | cosennecaeeoeneseesoosers 
| a SUBITEN LENGTH | NOT USED ns 
{ 14| ITEN NANE 2 {12 
| 15] {13 
| 16| \14 
| 17] 115 
| 20] 116 
| 21| |17 
| 22] 118 
| et Vi 
| a ITEN NO. oF SYNONYA - 
| 25| RESERVED. 1 | RESERVED 2 i“ 
| 26| ITEN TYPE | SUBITEN COUNT 2 
| 27| SUBITEM LENGTH | WOT USED 123 
| | 124 


The Iten Table starts in record #2. 
Each entry is 12 words long snd the length of the table depends on the 
nunder of data itens defined in the schena. The relative positicn of 
an iten definition depends on its relative position in the schena. 
Iten-nane: is a data iten nane, left-justified and with trailing blanks 
Iten-nunber-of-synonynm: is the nunber of the iten uhose nane has the 
sane hashed result as this cone (this is 
utilized for quick iten nane searches). 
Iten-type: is ene of the following: I, J, K, R, ¥, U, 2, or P 
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Reotfile Layout 
File - Next Record(s) (Con 


Set Table follous the Iten Table. Esch entry is 12 words long. The length 
of the table depends on the number of data sets defined in the schena. The 
relative position of a set definition depends on its relative position in the 
schena. 


Set-nane: is a data set nane, left-justified and uith trailing blanks. 


Set-nunber-of-synonyn; is the nunber of a data set whose nane has the sane 
hashed result as this one (this is utilized for quick set nane ses--hes). 


Data-set-type is one of the following: A, A, or DO. 


OSCB-pointer: is a pointer to the Data Set Control Block. This pointer is 
word offset fron record #0. The OSCE 1s described below. 


The naxinun size for this table is '2*199 = 2388 uords. 
NOTE: The reserved-1 and reserved-2 fields are the ‘old’ level nunbers for 


the read and write access respectively. Since this concept no longer ap- 
plies, the values are set to zero. 
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Rootfile Layout 


Root File Record Cont. 
ITEN-TYPE 
VAWES, 20J2; 
| | SUBITEN- - LENGTH 
|SUBITEN-COUNT 
The maxinun size for this table is 12*%1023 = 12276 uords 


NOTE: The reserved-1 and reserved-2 fields are the ‘old’ level nunbers 
for read and write security. Now, the values are aluays zero. 





R ile- Next Reco t Ta 
| 01234 5 6 7 8 9 10 1% 12 13 14 15 
ee es peed od bed oe ed ed od od ol 
| 0| SET-NARE-1 JO 
1| \1 
2] |2 
3| {3 
4| 14 
§| [Ss 
6) 16 
7| ' i 
| 10] SET-NO-OF- ~SYNONYN ! RESERVED- is 
| “ RESERVED-2 ORTA-SET-TYPE ‘4 
| OSCB-POINTER |10 
. " 
| ic SET-NANE-2 \12 
| 15| 113 
| 16] \14 
| 17 115 
| 20} 116 
| 21} }17 
| 22| 118 
| 23] , ue 
| 24| SET-HO-OF -SYRONYA is RESERVED-1 {20 
| 25] RESERVED-2. | DATR-SET- TYPE {21 
| 26| DSCB-POINTER {22 
| 27| 
| 30] 24 
6.23.00 
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Rootfile Layout 
R File - Next Reco fn 
ata n - ener ut 
| --2nn-nnnnnennmenennnnnnnnnnnnnnnnnnnmnnnnnnnnne=| 
| OATA SET GLOBAL AREA (SET 1) i | 
| (CAPACITY, LENGTHS, COUNTS, ETC.) 1] 
| | 
| RECORD DEFINITION TROLE (SET 1) 1] 
| A. ITEM NUMBERS | | DSCB 
| 8. ITEN DISPLACERENT ) | Set 
FIELDCOUNT*291 
| PATH TABLE (SET 1) {| 
| (SEARCH ITER, SORT ITER, Bless 1 | 
\. PATHCOUNT*3 } 
| CATA SET GLOBAL RREA (SET 2) 1 \ 
(CRPRCITY, LENGTHS, COUNTS, ETC) a 
rel a 
RECORD OEFINITION TREBLE (SET 2) i | 
A. ITEN NUNBERS } | Osce 
8. ITEN DISPLACEMENT | | S€t2 
FIELOCOUNT*2+1 : 
PA TH TROLE (SEY 2) 1 | 
(SEARCH ITEM, SORT ITEM, ETC.) I | 
PATHCOUNT*3 | | 
/ 


| 
DATA SET GLOBAL AREA (LAST SET) i\ 
(CAPACITY, LENGTHS, COUNTS, ETC) 1] 
uoS. | 
“RECORD CEFINITION TABLE (LAST SET) 1 | 
A. ITER NUMBERS | | ose 
8. ITEM DISPLACEMENT | 1 uA LAST SET 
FIELDCOUNT#2+1 et 

1} 

1} 

1 | 


PATH TRBLE (LAST SET) 
(SERRCH ITER, SORT ITEN, ETC. e 





PATHCOUNT*3 


a 

td 
| S09 B88 O28 08S CSS 0648 SG8SE OSE OSES SSS ES8SE49 SSS DSTSBTCO 
| SOS COO OSC CEO9S O98 C8828 2828S OE SOS SSSSSSSS2SSSSSSES8 


The OSCBs follow the SET TABLE in the Root File. There is cne OSCB for each 
data set defined. The function of the OSCE is to define each data set within 
the data base. 
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Reotfile Layout 
Root File - Next Record(s fA 


Data Set Control Block (Global Area) 


1234 5 6 7 8 910 11 12 13 14 15 


| | OSCAP (DATA SET CAPACITY) ° 
ol DSOUCKTR (KK EKG) l2 
al SeneounisTn (REDIN RECORD LENGTH) i3 
Jann Gna F 
s| oseuocerac TC OepatacT. SSCS 
s(oseutr ee ee oer \6 
Jc \? 

| gol odpntapta (OFFSET To PATH TABLE) is 

| nl ween oor 

! olmmr ks aust CC In 

| 15| 17 WORDS OF BINARY ZEROS SSS 3 

351 29 
|--nn-omnnenernronnnnncnncnnnnncencenncnnnnnnenne| 

DSCAP - Data set capacity as reported by the SCHENA processor. 


DSBLOCKLGTH - Data set block length including the bit nap overhead. 


OSNEDIALGTH - Data set nedia record length (renenter that this length 
includes the pointer overhead) 


OSENTRYLGTH - Data set entry length. 
DSBLOCKFAC - Data set blocking factor. 


DSPRTHCT  - Data set path count. This is the nunber of paths that are 
specified for the data set. 
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Rootfile Layout 
R File - Next R 
a Se ntrol ck (Rec efinition Iten acenen 
| 01234 5 6 7 8 910119 12 13 14 15 
eel beg td dd ed ol oo Cd 
| 0| OFFSET 10 1ST FIELD 


. WORD OFFSET TO 2ND FIELD 
2| WORD OFFSET TO 3RO FIELD 





tama | 


\ 
i 
| WORD OFFSET TO LAST FIELD 
i 


| LENGTH OF ENTRY 





This table innediately follous the Iten Nunters Table. 


The word offset points to the starting location of the field within the nedia 
record. Renenber that the media record includes the pointer overhead so this 
offset varies for nastar and detail data sets. If a naster data set has only 
one path, the word offset for the firet field ie 11, since there are 11 words 
of cverhead (6 words for the synonym chain pointers and 5 uords for the data 
set chain head that it would be pointing to). On a detail data set with cone 
path, the overhead is cnly 4 words. 


The *LENGTH-OF-ENTRY’ field is the sane as the nedia record length. 
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Rootfile Layout 
Root File - Next Record(s) (Cont. 


OSFIELDCT - Data set field count. Thais is the nunber of fields 
specified for the data set. 


X-DSKEYTYPE - Data set key type. If OSKEYTYPE = TRUE then 
the key 18 hashed. 


DSPRINKEY - Data set primary path or key. 
For naster data sets, this is the field nunber of the 
search iten. 
For detail data sets, this is the field nunber of the 
prinary path. 


DSPATHPTR - Data set path table pointer. Word offset to the data set 
path table which contains an entry for each path defined. 
It points to path Oth entry in the table, so to get to 


the first entry the pointer should be increnented by the 
length of the entry (which is currently 2 words). 


Data Set Control Block (Iten_Nunbers) 


| 01234 5 6 7 8 9 10 11 12 13 14 15 
--|--|-=|-=|-=|=-l--]2=1-=be= to-do b-bd =| 


| O| ITEM NUM OF 1ST FIELD 


| 
2| ITEM NUM OF 3RD FIELD | 


|-nnnnnnnnnnennnnnnnnenennnneenes mencennnnnnanes | 
.{ €TC. | 


The Iten Nunbers Table follows the Global Area of the DSC8. The size of this 
table (in words) is equal to the nunber of itens in the given data set. 
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Reotfile Layout 
Root File - Next Reco ont. 
Data Set Control Block (Path Table) 
| 01234 85 6 7 8 91011 12 13 14 15 


i! 2ND PATH DEFINITION 
S| 





| SO 8808 OSO9O SOG SS8SS9E SE 8G889 8S SESS HSSOSDOOEOOOE | 


eecee: PPD OE OO OS OOS C28 COSSS2OOSOE 2O828804 ©2622 OTOSCS® 


| 
| | LAST PATH DEFINITION | 
|--waennennnaeenenn woennnncenaenseecennn nme nnne | 


There are 3 words (6 bytes) for each path definition. The Path Table 
for naster data sets has a different layout fron the Path Table for detail 
data sets. 


faster sets: 

Byte Description 

1-2: iter nunber of the search iten in the related 
detai! set. 

3-4: item number of the sort iten in the related 
detail set. 

§: set nenber of the related detail data set 
6; path number of the corresponding path in 
the resated detail data set. 


Detail sets: 
Byte Description 
1-2: field nunber of the search iten. 
3-4; f:eid nu. der of the sort iten. 
35: set nurder of the related master data set 
6: path cunber of the corresponding path in 
the related naster data set. 
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Rootfile Layout 


Root File - Next Record ont. 


Device Class Table 
| 01 2 


6 7 8 9 10 11 12 13 14 15 


| 
| O| BEV CLASS NAME 1 
1 \1 
rd | j2 
2 : 
4| DEV CLASS NAME 2 \4 
5| i§ 
6} 16 
C : 
| 10| DEV CLASS NAME 3 \8 
| 11] 19 
| 12| 110 
| 7 i: 
| 14| DEV CLASS NAME 4 [12 
| 15| \13 
| 16] 114 
| ” ms 
| 20| 116 


Device Class Table follows the DSC8s. 


Each entry is 4 words long, and contains the device class nane which is cp- 
tionally specified for a data set by the user. for data sets without user 
epecified device class nanes, the entries will be filled with blanks. 


The length of the table depends on the nunber of data sets defined in the 
schena. The relative position of a device class entry depends on its rela- 
tive position in the schena. 


The naxinun size for this table is 4*199 = 786 words. 
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Word 0-1: Record nane of the highest readable record. Record nane consists 
of an NPE file record nunber (0 byte to 2nd byte) end a slot nun- 
ber (3rd byte), where the NPE file record nunber is equal to the 
quotient of the highest entry divided by blocking factor and the 
slot nunber is equal to the renainder of the highest entry divided 
by blocking factor. For Masters, this is the highest record in 
the set (i.e., Capacity). For Oetaile this is the greatest nunter 
of records that have been written to the set thus far. For ex- 
anple, if there is rocn in the Detail data set for 100 records and 
75 were written last week when the data set was loaded with 
DBLORD, and yesterday 15 records were deleted fron the data set, 
the High Water Mark should point at the highest entry, '75', in 
the forn of record nane. If the data set has 2 blocking factor of 
10, the record nane should have an RPE record nunber of 7 and a 
slot nunber of 5. 


Word 2-3: Nunber of unused records in the data set. This field is incre- 
mented uhen a record is deleted and decrenented uhen a record is 
added. To deternine the current nunber of entries used in the set 
subtract Word 2-3 (unused count) fron Word 0-1 (Capacity). 


Word 4-5: The delete chain head for Details. This points to the record nest 
recently deleted or contains 3 value of zero if no records have 
been deleted. This field is not used in Master data sets. 


Data Set Records 


The data ir the data set records is arranged according to the Media records. 
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Rootfile Laycut 


neral Data Set Layout 


| 
WORD 0-1] MASTERS=CAPACITY 
| DETAILSSHIGHWATER MARK = | 


| 
WORD 2-3] NUMBER OF UNUSED RECORDS | 


| 
WORD 4-5| MASTERS: NOT USED | 
|DETAILS= DELETE CHAIN HERD 


|--RECORD 0 THROUGH N------- l 
RECORD 0| 


| _ORTA RECORDS 


| 
RECORD . | 
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CHAPTER 22. DISC FREE SPACE NAP 


Resident Data Structu 


There are tuo dise resident free space data structures, the bit nap and the 
descriptor table, for each disc volune that has a free space map, i.e., sys~ 
ten discs and private volunes. The addresses of these data structures are 
kept in the disc label. The synbols that define the descriptor table and bit 
nap are in the include file INCLDFS2. 


Bit Nap 


The bit nap is divided up into pages, which is the physical block of the nap 
that is read or written. At the nonent, 2 page is defined to be one sector 
long (128 words), This may be changed by changing a conpile tine constant. 
The last word of the page is a checksun for that page, all other words are 
data. There is a one to cne correspondence betueen bits in the nap and sec- 
tors of the disc. A cne bit represents a free sector and a zero bit 
represents an allecated eector. The bit nap is a contiguous set of pages, 
enough to represent the entire disc, excluding spare tracks and spare 
sectors. 


rita 7 


The descriptor table is an array of three uord entries, one entry for each 
page of the bit map. Each entry looks as follous: 


| 
WORD *| LARGEST SPRCE 


| 
WORD 1 STARTING SPACE 


| 
WORD 2] ENDING SPRCE 
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Disc Free Space fap 
The descriptor table looks as follous: 


| ese2eewowene | 


| JENTRY FOR PAGE 0 


| JENTRY FOR PAGE 1 


| JENTRY FOR PAGE 2 


exeeee2oee 


| 
| JENTRY FOR PAGE 3 
| 


| JENTRY FOR LAST PAGE 


Each entry describes the free space on the corresponding page of the bit nap. 
The largest space word is the size of the largest contiguous block of free 
space on the page, which 1s not at the very beginning or very end of the 
page. That is, the first bit physically representing the space 18 not the 
first bit of data on the page or the last bit representing the space is not 
the last bat of data on the page. Starting space is the nunber sectors of 
contiguous space represented by the set of bits whose first bit 1s the first 
bit of data on the page. Ending space is the nunber of sectors of contiguous 
space represented by the set of bits whose last bit is the last bit of data 
on the page. The starting space and ending space fields allow looking across 
page boundaries, thus preventing fragnentaticn on page boundaries. 
Therefore, if all sectors represented on a page are free, then starting and 
ending space will be the sane and have the total nunber of free sectors 
represented on the page. Largest space will be zerc, as there is no block of 
space that is not at the beginning or end of the page. A value of - 1 for 
all the fields in an entry indicates the corresponding page is bad, either 
fron a checksun or I/0 error. 


ual Men Resident Data Structures 


For each systen disc or physically mounted private volune there is a data 
segnent which has information about the disc free space map, the current copy 
of the descriptor table, sone work space for the procedures while in splat 
stack node, and buffers for pages of the bitnap. The DST nunber of the data 
segnent for a given disc is found in the LDTX entry for that disc. 
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Da truct n 

CRM DE SE ATED AE AP DE Eb SS ED Te EG AS OE Pe EP Ee | 
| 23| ODS’ LAST’ PAGE’ ALLOCATED’ FROM |19 
| 24| OS’ NEXT’ BUFFER’ INDEX hag 
| 25| OS PAGE NUNBER \21 
| 26| OS’ WORD’ NUNBER Hig 
| 27{ OS’ BIT NUMBER a 
| 30} OS’ PAGE’ POINTER |24 
| 31| OS’ STARTING’ WORD’ NUMBER 125 
| 32] OS’ STARTING’ BIT’ NURBER e 
| 33| {27 

|- DS’ NUNBER’ OF’ SECTORS -| 
| | Ja 
| = OS’ BIT’ COUNT a 
| 36] OS’ ENTRY’ TYPE ha 
| 37| OS’ BUFFER’ INDEX hd 
| 40| |32 

|- OS’ OISC’ ADORESS - 
| 41] hi 
| 42] OS* ERROR’ STATUS |x 





The rest of the data segnent contains tables whose size and location is 
dependent on the size of the disc and/or the nunber of buffers in the data 
segnent. They are shoun below just to denonstrate their relation to one 
another, for their actual location, the pointers should be exanined. The 
synbol "DS’ARRAY’ARER" defines the start of the area. The first table is the 
descriptor table, it ie in the sane format as the disc copy, but a Gunny 
entry of all zeros is added before and after the table, these are needed by 
procedures "FINDPAGE and “BUILD'DESCRIPTOR'ENTRY". The pointer to this 
table is “OS’DESCRIPTOR’ TABLE”, it points to the entry for page zero, not the 
dunny entry. 
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Diasec Free Space Map 
F Space Data nent 


For each systen disc or physically mounted private volune in the up and run- 
ning systen there is a OST which contains anfornation about the disc free 
space nap for that disc, sone work area, a copy of the descriptor table and 
buffers for the pages of the bat nap. 


All synbols that define these data segnents are in the include file INCLOFS1, 
and they are prefixed with "DS’". The structure of the data segnent is as 
follous: 


| O| 0S’ LEV jo 
| oso t 
ft hee. i 
|- DS’ DISC’ SIZE | 
| 3 
| al OS uaST PaGE-OF RAP 4 
| s|"osviaST-BUFFER'INBEK 5 
nT Deen 16 
|- DS’ RAP’ ADDRESS -| 
| |? 
| tol osuce “Is 
| inf osruacRcouT 9 
| 12|" OS-QUEUE'NERD 10 
| 13] os-aueue'tant id 
| nal” os OESCRTPTOR'THOLE 12 
| 15| OS BUFFER pnce'WuReER +13 
| tel osreurrER-oreTy 
| 17| osrourreR'mnER NS 
| 2o|” Os FIRST THEO Pa *N 


2 \17 
|- OS°SIZE°OF*LAST’ALLOCATION 8 = -| 
22| 1 
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| 0 | 


| onveannnnwenewnnnnnnwcnnnnnnnnnn= [DUMMY 


| 0 


| --------a enn nnn nen nnnn nn nn nnn ne= ENTRY 

| : | 

| LARGEST SPACE 

[onan n-nonneneeneneonenencnnnennne JENTRY FOR 
| STARTING SPACE | 

| -wonennnnnnanennween onenae-nn--- [PAGE 0 

| ENDING SPACE 


| 
| LARGEST SPACE 
| STARTING SPACE 


wo eee w enn cn wnwoccccocnncocoence= | PAGE 1 


| ENDING SPACE 


| LARGEST SPACE | 
eeamrasia ese eenwerennoe=--==~ [ENTRY FOR 
| STARTING SPACE 


| 
| ENDING SPACE 


| 0 


| pn ee nnn n wn nw nen ceweweneoeonencees | HUNMY 


| 0 


| ea ew enn ecm mw wn noe ewsceosoncceen~ | ENTRY 
| 0 





The next table is OS’BUFFER’PRGE’nunbder table, it has a one uord entry for 
each buffer in the data segnent. Each entry contains the page nunber of the 
page currently in the corresponding buffer or -1 if the buffer is enpty. 
This is poin*ed to by “DS’ BUFFER’ PAGE’ NUABER™. 


| GUFFER 0 ENTRY [ 

See © 28 S2S28 © 2242E 2424 €2E8 424228280 0280028 | 

| BUFFER 1 ENTRY | 

oe =| 

| LAST BUFFER ENTRY i 

| nancecnceecnnannenewennenennennns| 
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The next table is the DS’BUFFER’DIRTY table, which has a one uord entry for 
each buffer. A TRUE andacates the page in the corresponding buffer 18 dirty, 
i.e., the dise copy 18 not up-to-date. A FALSE indicates that the buffer is 
clean. If OFS was conpaled wath dirty buffer nanagenent turned off, this 
table is not present and the OS'BUFFER’DIRTY pointer 18 zero. 


| 
| BUFFER © ENTRY 


|--nncenennneneo= eneeeeecnnenenen= | 
| BUFFER 1 ENTRY | 
| NS OSODSESDHEDEOSHSTABDSB® SSB Seaeoeo | 
OS 28S 4SE6 028 O2O88E 90822808 OD GP PER GP GhE Paap | 
| LAST BUFFER ENTRY | 


The renainder of the data segnent contains the buffers. Each buffer is the 
size of one page of the bat map, which is currently one sector(128 uords). 
The beginning of the buffer area is pointed to by “DS’BUFFER’RREA” and the 
nunber of buffers is the value in “OS’ LAST’ BUFFER’ INDEX" plus one. 


BUFFER 0 





| 
| 
| 
| 
| 
| 
| 
! BUFFER 1 
| 

| 


EP ED ADEE ED OPEE ODP DP OSSODOSOSSSS | 


| | 
| | 
| LAST BUFFER | 
| [ 
I l 
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CHAPTER 23 APE DISC CRENING 
achin rv 


Disc Caching is an opticnal feature of MPE that utilizes excess nain 
nenory/CPU horsepouer to keep portions of frequently referenced disc 
“donains” in menory. (A dise “donain" is a copy of a portion of disc resid- 
ing in main nenory. These disc donains are considered “cached" when they are 
in nenory and are considered “napped™ when there is I/0 pending sgainst 
then.) Dise Caching manages the bi-directional transfer of these disc 
donains between nain menory and disc storage. Mo main nenory is pernanently 
dedicated to cached disc donains. Cached dise donains share nain nenory with 
all other types of NPE segnents and are not treated differently by the nenory 
nanager. By keeping cached disc donains in nenory, a significant portion of 
the references to disc storage can be resolved without actually needing to 
physically access the disc. Disc Caching policies are integrated into the 
APE Kernel, File Systen, and 1/0 Systen which allows the systen perfornance 
to be tuned based cn the current workload and resource availability. 


Disc Caching uses the NPE kernel resource managenent nechanisns and 
strategies. These nechanisns are extended to handle cached disc donains in 
the sane manner as hee Thus, cached dise denains can be of variable 
size, fetched in parallel with other segnents or cached dcnains, garbage col- 
lected, and replaced in the sane nanner as stacks, data and code segnents. 
The relative use of nain nenory betueen stacks, data and code segnents, and 
cached disc donains is dynanic. This partitioning is based on the current 
uorkload requirenents and current nertory availability. 


Dise Peers can be enabled/dissbled en a disc-by-disc basis. hen caching 
is enabled for the first disc, the cede segnent containing the Dise Caching 
code will be locked into menory. Also at this tine the Cache Directory Table 
(COT) will be built and locked into menory. When caching is disabled for the 
last disc, the code segnent will be unlocked fron nenory and the COT will be 
released. Thue if caching ie not enabled no nenory will be ussted. 


The COT is used te keep track of the following infornation: 


1. The dise Ldeve currently enabled for caching. There will be a Device Entry 
in the table for each cached disc. 


2. A linked list of cached donains for each disc with caching enabled. The 
head and tail of thie linked list will be contained in the Device Entry 
(i.e., _— is a separate linked list of cached donaine for each cached 
disc ldev). 


4. The cached donaines that currently have user 1/0 pending (i.e., 
FREADS/FURITEs) or have nenory managenent 1/0 pending (i.e., fetching the 
disc donain into menory, or posting the dise donain back cut to dsec). 
There will be a Mapped Donain Entry in the table for each disc donain has 
that 1/0 pending and is thus “napped". 
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Each of the fields of the data segnent 18 described in the include file 
INCLOFS1, where they are defined. It should be noted that the following 
fields are just workspace, used to pass infornaticn between procedures while 
in split stack node and have no meaning betueen calls to the disc free space 
Managenent subsysten: 


DS’ PAGE NUMBER DS* WORD’ NUABER 

DS’ BIT’ NUMBER DS' PAGE’ PTR 

DS’ STARTING’ WORD’ NUMBER OS’ STARTING’ BIT’ NUMBER 
OS’ NUMBER’ OF ' SECTORS DS’ ENTRY’ TYPE 

DS’ BIT’ COUNT DS’ BUFFER’ INDEX 

DS’ DISC’ ADDRESS 


The field OS’ERROR’STATUS normally has no meaning betueen calls unless the 
ERROR’ TYPE field has a value greater than “FATAL'’OFS’ERROR”, uhich neans that 
disc space may no longer be allocated on this disc. 
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4. A linked liet of all user I/0 pending against the napped disc denains. 
There will be a togical Disc Request (LOR) queued to the Mapped Donain 
entries that will describe the user 1/0 to take place. This is analogous 
to a Disc Request queued to a specific DIT waiting for service. 


Uhen a request is nade to access disc information, Disc vee? nust first 
deternine if the requested disc donain is present in menory. Dise Caching 
will first deternine if the requested area of disc is already napped into 
nenory by scanning through the flapped Donain entries of the COT. If the 
requested transfer can be satisfied with a currently mapped disc donain, then 
the I/0 request will be queved (FIFO) behind the other I/Os pending against 
that mapped donain. If the requested area is, not already napped, then a 
search is nade through the linked list of cached disc donains for the 
specified disc Ldev. (The region header contains the disc address and size 
that a disc donain represents.) If the requested donain is found in this 
list (i.e., present in nenory), then this regacn will be mapped. fA donain is 
then considered napped when there is an entry for it in the Rapped Donain 
portion of the COT. Napping the donain allous Disc Caching to manage either 
3 pending or currently active 1/0 for a particular disc donain. Once the 
disc donain is napped and present, the data can be moved betueen the process’ 
data area and the napped disc donain. The process can then continue execut~ 
ing without interruption or a procese suitch. The user/subsysten precese for 
which the nove is done will be charged with the CPU overhesd. 


Uhen a request is made to read data that is not currently cached in nenory 
(i,e., a read “niss"), the fetch strategy uses the File Systen’s knowledge 
of the type of access (sequential or randon), the extent size of the file, 
along with the current nenory load to select the cptinal size of the disc 
donain to be fetched and mapped into nenory. The fetch of the disc donain is 
then initiated on the user’s stack without a process suitch. After the fetch 
is initiated, it conpletes in an unblocked manner so that this process (if 
no-wait I/0) or another process can pruceed in parallel with the cache fetch. 


In general, when writing, a process will not uait for conpletion of the 
physical 1/0. Instead, the process will be awakened as soon as the transfer 
has conpleted betueen the process’s data area and the mapped diec donain 
(i.e., no-wait-for-post). The physical 1/0 will then be posted at background 
priority while the process continues. (Users can specify wart-for-post on 3 
file by file basis in place of the default no-wait-for-post with the FSETRODE 
intrinsic, or on a glotal basis via :CRCHECONTROL.) If the sccess request is 
a urite and there is a current urite pending against the specified napped 
disc donain, the procese request is queued until the pending urite is posted 
to disc. If the disc donain to be uratten is not currently cached in nenory, 
a free piece of menory vill be ebtained to nap the corresponding diec inage 
and then the “write” tab:s place fron the process’ data area to the mapped 
dise domain. This prevents data fron naving to be read before being written. 
After that, a post to disc is initiated (un any write only the portion of a 
napped disc donain that is “odafied .i1] be posted to disc). After the nove 
to the mapped disc donain is complete 2d che post to disc is initiated, the 
process performing the “urate” 18 ailowed to continue to run without having 
to wait for the post to complete. Writes that must be posted to disc in a 
certain order use the Global Serial Write Queve. These ordered writes in- 
clude things like updating dase free space naps for a neu file extent before 
updating the file extent nap in the file label. 
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There are tuo disc request entries used for disc caching requests. The first 
entry is a Logical Disc Request (LOR) entry and is used to manage the data 
noves to/fron the user’s data area and the disc donain (1.e., the logical 
1/0). The second entry 18 a regular Dase Request (ORQ) entry and is used to 
perforn the physical I/0 necessary to nap a disc donain (for a read “niss") 
or to perforn the physical post (on write requests). The disc donain will 
renain mapped until both the logical and_ physical 1/0 conpletes. If a 
request is not completely described by one disc donain already in nenory or 3 
Mapped Donain CDT entry (i.e., the requested disc area falls into nore than 
one disc donain) then the overlapping disc donain(s) will be flushed to disc 
and the new conplete disc donain will be fetched (if read) and mapped. No 
partial nappings are allowed. 


The OST nunber of the Cache Directory Table (CDT) is at 21273 and the bank 
and offset are kept in 21274-21275. The Caching SIR (2) is used uhen start- 
ing and stopping caching (via sSTARTCRCHE/:STOPCACKE) and by the LOADER uhen 
loading a progran file (this SIR is only used when updating the STT at load 
tine). 


Uhen caching is enabled for a disc, a bit in the flags uord of the DIT is 
set. filso, the Global Serial Write queue can be found by exanining the 
header entry of the Disc Request Table. See Chapter 13, “1/0", for a nore 
detailed explanation of both the DIT and the Oisc Request Table header. See 
Chapter 2, "Nenory Managenent Tables", for a description of the Menory Region 
Header for a disc donain (cached region). 
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| (CACHED DISC DOMAIN) 
"I (DEV # 1) 


<e 


| 

| | 
--->| 1ST CACHED REGION | 
| 

| 


| SPR OCOOSCOCHSOHSL OO SCECESEZC® | 


| 
| 2NO CACHED REGION = |----| 
| (CACHED DISC DOMAIN) | 
=| (0&V #1) |<---] 
| 


ooo) 


{ 
--->| MAPPED CRCHE REGION |---- 
w---->|(NRPPED DISC OONAIN WA)| 


j----]  (OEV @ 1) |co-=| 
; | i | 
| [eseeceeene- wecccccennm-| | 
j { 
| : | 
| . | 
| . | 
| | 
! |-eeceerenenennnennnwone| ! 
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| | 
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Disc Caching Tables Overview 


ache Directory Table (CDT 


| 
| 
| 
| 
Io—=| DEVICE ENTRY @ 1 eeecewwone 
| 
! DEVICE ENTRY # 2 
| 


282288 HOOOSESHOBZOXESOO 


J-|--->] APPED OORAIN WA |---------------> TO 1ST LOGICAL 
1 | t->] FOR DEV #1 |--| OISC 

[ [| [ecrececceecenececnnnee| | REQUEST 
rldot | | ENTRY 

| | [--| RRPPED COMAING 8  [<-| (LOR) 

1 [| j->} FOR OEV # 1 |--| 

L [1 [ecococcccewennnseeenne 1 | 

tld in| 

| | j--{ MAPPED DOMAIN CC j<-| 

11 | FOR DEV # 1 | 

| | [recone ence wenncnnnene=| 

It od | 

i! | . | 

I) | . | 

| . | 
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Cache Directory Table 


The Cache Directory Table (COT) is the bookkeeping structure for managing 
cached disc donains. This table is divided into three parts: 


1. COT Header Entry 
This entry contains all information necessary to manage the entire table 
and also contains global caching related information. 
2. CDT Device Entry 
There will be one of these entries for every disc Ldev that currently has 
caching enabled. These entries keep track of all cached disc donains in 
nenory for this device. In addition, these entries contain statistics 
regarding the nunber of 1/08 perforned to the Ldev. 


3. COT Mapped Donain Entry 
These entries describe disc donains that are currently “napped" into 
nenory. This neans that there is logical 1/0 (cache nove) and/or physical 
1/0 (fetch or post) pending. These entries keep track of the state of the 
cached disc donain (IMI, ROC, etc.) just as the OST Table keeps track of 
data segnents. 


The following low core cells contain the address of the COT: 
21273 - contains the DST Nunser of the COT 


41274 - contains the Bank Nunber of the COT 
21275 - contains the Offeet within the bank of the COT 
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Header Entry 
| poreocennnnneceeennnne ecrecnermereenceeen | 
O| # ENTRIES |COT’ ENTRIES 
" ENTRY SIZE (232) SPOUSE 
2 W FREE ENTRIES | COT’ FREE* COUNT 
3] 1ST FREE ENTRY (TABLE OFFSET) COL SEREE EO 
| eocescnnncesconcoceconacewsceoscoescncoes 
4] LAST FREE ENTRY (TABLE OFFSET) hese 
| weeecceccccouownceecccosenececcocenswonecrn 
S| MAX ® ENTRIES USED eve USED 
‘| # LOEVS CACHED |CDT* NUN’ LDEVS 
7] 1ST CACHE DEVICE ENTRY (ENTRY NUMBER) |COT'DISC’ HERD 
10| # WORDS THIS OST |COT’ DST’ WORDS 
au TRUE IF STOPCACHE PENDING {COT’ STOP" PND 
12] # SECTORS SEQUENTIAL FETCH adic 
| # SECTORS RANDON FETCH [CDT’RNO’NINFTCH 
a TRUE IF WAIT FOR PHYSICAL POST sPOTeEURES OST 
| HEAD OF INPEDED QUEUE (PIN) ICOT’ STOP’ QUEUE 
16] | 
| : | 
| | 
| l 
31| | 
| poerecennnnnnnnn nn newncwewerwennnccenonn| 
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CDT’ RND’ MINFTCH 


This is the sane as COT’SEQ’NINFICH except that it’s for randon access. The 
default value is 16 sectors. (This value nay be changed via :CACHECONTROL. ) 


COT’ FORCE’ POST 
When this value is TRUE, all urites will “block” until the physical update on 
disc conpletes. The systen default is FALSE. (This value nay be altered via 
:CACHECONTROL. ) 


COT’ STOP’ QUEUE 
If CDT’STOP*PENDING is TRUE this will be the PIN nunber of the head pin of 
the processes inpeded until the :STOPCRCHE conpletes. 


COT’ DE’ NEXT* LDEV 
The entry nunber of the next Device Entry. | 


CDT’ DE’ PREV’ LDEV 
The entry nunbder of the previous Device Entry. 


COT’ DE’ WEY 
The Ldev nunder for this cached device. 


COT’ DE’ NAPD’ PAGES 

Total nunber of nain nenory pages allocated to disc donains for this cached 
pHa includes mapped and unnapped regions. (1 main nenory page * 
128 words). 


COT’ OE’ MAPD’ CNT 
The total nunbder of Napped Donain entries associated with this Device Entry. 


CDT’ DE’ MAPD’ HERD 
The entry nunber of the first Mapped Donain entry for this device. 


COT’ DE’ MAPO’ TAIL 
The entry nunber of the last Mapped Donain entry for this device. 


COT’ DE’ REGIONS 
The total nunber of disc donain regions for this Ldev (includes mapped and 
unnapped regions). 


COT’ DE’ REG’ HD 

Menory address to the head region of the disc donain linked list. Disc 
donain regione are linked in order based on the disc address they reoresent 
(i.e., small disc address at head, large disc address at tail). This add-ess 
will not point to the region base (RS), but to the next donain (NC) field cf 
the region header. (This is to facilitate the use of the Lton instruction. ) 
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COT’ ENTRIES 
The total nunber of CDT entries configured in this table (1.e., includes all 
three types of entries). The nunber of entries in the table will be: 
1 entry for the header 
+ 1 entry for each disc Ldev configured. 
(COT Devace entries) 
+ 1 entry for each ORG configured. 
(COT Napped Donan entries) 


This schene insures that this table can never overflow (since an entry in the 
ORO table is aluays obtained before an entry in this table). 


COT’ SIZE 
Size of each entry in the table. 


COT’ FREE’ COUNT 
Total nunber of entries currently unassigned. 


COT’ FREE’ HEAD 
Table relative offset (i.e., Entry nunber * entry size) of the first avail- 
able entry. 


COT’ FREE’ TAIL 

Table relative offset of the last available entry. 
COT’ MAX’ USED 

The maxinun nunber of entries in use at one tine. 
COT’ NUN’ LDOEVS 

The nunber of ldevs currently cached. 

COT’ DISC’ HEAD 

The entry nunber of the first Device Entry. 

COT’ OST’ WORDS 

The total nunber of words in this data segnent. 
COT’ STOP’ PND 

This value will be TRUE if there is a pending :STOPCACHE. 
CDT’ SEQ’ NINFTCH 


If there is a prefetch for a sequential read ("nise"), the size of the 
prefetch is delinited by the extent size of the file. Within this linita- 
tion, the prefetch is equal to the greater of tuo sizes: 


1. Requested size. 


2. The largest integer multiple of the request size that is snaller than the 
value found in this cell. 


The default value is 96 sectors. (This value may be changed via 
sCACHECONTROL. ) 
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COT’OE’ REG’ TL 
flenory address of the tail region of the disc donain linked list. This ad- 
dress will be of the previous donain (PD) field of the region header. 


COT’ OE’ RHIT 

Total nunber of tines that a read was requested and the requested disc donain 
was present in menory (i.e., a read “hit"). This means that the read con- 
pleted without perforning any I/0 (to fetch the donain). Thus this is ac- 
| the nunber of read I/0s elininated. This value will reset to zero on 
overflow. 


COT’ DE UHIT 

Total nunber of tines that 8s write was requested and the requested disc 
donain was present in nenory (i.e., a urite "hit"). If there was no other 
urite pending to the “hit” donain, then the process uould continue as soon as 
the cache nove conpletes, therefore, elininating a block for 1/0. Otherwise, 
the process would block waiting for the first urite to complete. This value 
will reset to zero on overflou. 


COT’OE’RAISS 

Total nunbder of tines that a read was requested and the requested disc donain 
was not in nenory (i.e., a read “niss"). This neans that the requested disc 
donain had to be fetched into nenory before the read could conplete, there- 
ores Eee blocking the process. Thie value will reset tc zero on 
overflow. 


COT’ OE UAISS 

Total nunber of tines thet a write was requested and the requested disc 
donain was not in menory (i.e., a urite "nise"). This does not nean that the 
process would block until the disc donain is fetched as is the case for 
reads. Rather, a free nenory region would be obtained to be the destination 
of the cache nove. This disc donain would then be posted in the background 
(unless overridden vias :CACHECONTROL or FSETMODE) allowing the process to 
continue without blocking. This value will reset to zero on overflow. 


COT’ OE’ STOP 
Total nunbder of tines that a process hed to block on a cache transfer. Will 
reset to zero cn overflou. 


COT’ DE’ SCANPT 

The nenory address of the last region looked at on a search. This address 
will be of the next donain (ND) field of the region header. This value wall 
be used along with COT’DE’REG’HD to deternine uhere to start the next search 
for a cached disc donain. At tines it will be more efficient to start uith 
this addrese since the disc donain requested nay be of a higher disc address 
On nce ia this region header, rather than aluays starting the search with 


COT’ DE’ SHIFT" CNT 
The nunber of bits used to execute OLSL instruction. 


COT’ DE’ MAKE’ EVEN 

An additional word used to nake the entry size an even nunder. 
COT'ENTRY’SIZE nust be an even nunber for disc caching to correctly access 
the CDOT Device Entry Table and the Mapped Donain Entry Table. 
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Device Entry 


CSS OS CS 98 £8 228 2ES 440248 BEOASHSSERDASSOSBVESOO 


| | 
O| NEXT LDEV ENTRY (ENTRY NUMBER) |COT’ DE" NEXT” LDEV 


1 "prey iDev ENTRY (ENTRY MURGER) CDT’ DE*PREV’LDEV 
imme lcor*be* ev 

sl Sues IIE ti Ico bernieg BRGES 
al "acs ponaDN® CUMRENTLY BRoPED \eDT*OE*RAPOCAT 


90S S 000088884 OSS 806 Ce SHOT BTOERBVSSACTEOTSCCS 
eer ee ee rr 


| 
7| # DISC DOMAIN REGIONS FOR THIS DEVICE (CDOT’DE* REGIONS 


| erene wenn n ncn cnc ennne nnn eenenecnncnnsoen | 
10] MEMORY ADDRESS OF HERD popente ne 
| CACHED OISC OONAIN | 
| eown ce wens cc acsceseevawsccesceesenoesces 
i MEMORY ADDRESS OF TAIL Jeby Reena 
| CACHED OISC OONAIN | 
|COT’ DE’ RHIT 
{- # READ HITS -| 
| | 
| enn n new n none e mene roecnnewenrooeerorcosn | 
16| |COT’DE* WHIT 
|- @ URITE HITS -| 
| | 
20| |COT*OE’RAISS 
Ir # READ MISSES “| 
sececscacwensecsnccns wen snnoessennasscese | 
|COT*DE’ UNISS 


|- # STOPS | 
| 
se: MEMORY ADDRESS OF LAST oe 
| REFERENCED DOMAIN 
a # BITS TO SHIFT |CDT’OE* SHIFT’ CNT 
31| NOT USED eee eae 
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COT’ MD’ PREV 
Entry number of the previous mapped donain entry for this device. 
COT’NO’ NEXT 
Entry nunber of the next napped donain entry for this device. 
COT’ND’ SECTOR 
The starting disc sector address representing this napped donain entry. 
COT’MD’ END’ SECTOR 
The ending disc sector address representing this napped donain entry. 
COT’ MD’ FLAGS 


Flags describing the state of this mapped donain entry and the region as- 
sociated with it: 


(0:1) - Absent. 
Region is not present in nenory. 
(1:1) - Jn. 
Region is already In-flotion-In. (Set when the fetch for this 
cecres region is initiated.) 
A 


Region is In-Motion-Out. (Set by STARTOBJURITE when perforning 
the background post of a cached region. 


(2:1) 


(3:1) : 
This disc donain was not present and had to be prefetched. 


431 LOCK. Not d. 
ay - ane aaa 


Forced Urite In Progress. Region was forced out of mencry to 
nake roon for another object. 

(6:1) - ROC. 

Recover Cverlay Candidate. Region nay be forced out of nenory 
to make roon for another object. However, if this region is 
referenced again it can be recovered. 

(7:1) - VIRGIN. 

Clean region in the urite state. Cleared as scon as 3 nove 
conpletes. (I.e., if this bit is on, then a urite can conplete 
innediately. Otherwise the urite will have to wait until the 
current urite completes the physical post.) 

(8:1) - NNPOST. 

Set uhen the CDT is being posted cut as a result of a urite 
request that did not want to wait for the physical post to con- 
plete. This will be cleared by the cache conpletor uhen the 
physical post conpletes. (This is used to insure that a cache 
nove for any subsequent urite request will not be serviced un- 
til tne physical post conpletes. ) 

(9:1) - SEQ. 

Set if doing sequential I/0. When the request for the last 

area of this disc donain 1s complete, this donain will be nade 


F : 
(10:3) - Not used. 
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Mapped Donain Entry 


| ------ceeeeeeeeenesnennnenenecnaenesetes | 
O| PREV MAPPED DOMAIN ENTRY (ENTRY NUMBER) |COT’ AD’ PREV 


| 
2| START SECTOR ale 
|- - 
ADDRESS | 
4] LAST SECTOR ICOT’MD' END’ SECTOR 
|- = 
RODRESS 
6] AL II TU MP LL FI Ri vii Ss}! | Ss |COT’ NO’ FLAGS 
1} ej nj a} rl of ul oj} mojer | t 4 
sj x] ol SE CLI} cl RiPlQi | aA | 
El | S|PKEPL | GIO) | | tT | 
par fet ver bt umst tte | 
| Th | Lt Pot ot Until dt | 
# RERDS PENDING COT’ MD’ READ’ CNT 
10] # WRITES PENDING CDT’ AD’ WRITE’ CNT 
141] LOCK WAITING ap ae 
12| HERO OF INPEDED LDR eo ae 
13] HEAD OF ACTIVE LDR |COT’ MD’ LOR’ HEAD 
| REMORY ADDRESS {COT’ND' MEN’ ADR 
| IF PRESENT | 
16] ORQ FOR THIS MAPPED DONAIN CDT’ ND’ DISCREQ 
17] ® FLUSHING CDT’S er ee 
20) LOEV FOR THIS MAPPED DOMAIN POTN WEY 
21| HEAD INPEDED QUEUE (PIN) {COT’ND’ IMPEDED 
22] OEVICE ENTRY (ENTRY NUNBER) jeer De 
23] | |COT’ND' DEFERRED 
ENTRY LENGTH | 
31] | 
| cocwnn nnn noma nn mewn n enn nnnnacn een eenne=| 
6.23.00 
23- 12 


MPE Dise Caching 


(13:3) - STATE 
0 - AVAIL. COT is an available entry. 
1 - READ. Only read LOR(s) are attached. 
2 - WRITE. Write LOR(s) and possibly read LDR(s) are 
attached. 
3 - FLUSH. COT is being flushed cut. 
4 - LOCK. Unused. 


COT’ MD’ READ’ CNT 
The nunber of LDRs attached that are for reads (nove not conplete). 


COT’ AD’ WRITE’ CNT 

The nunber of LDRs attached that are for urites. NOTE: This count will not 
be decrenented until both the cache nove and the physical urite conpletes. 
peeerece as soon as the cache nove conpletes, the LOR will be dequeued fron 
the . 


COT’ MD’ LKD’ COT 
Not used. 


CDT’ AD’ INPED’ HD 

The first LOR that is inpeded. (I.e., the COT is in a urite state already and 
another urite is attached. The second urite will be placed in this queue un- 
til the first urite conpletes.) 


CDT’ND’ LOR’ HEAD 
The first LDR that is on the active list for this COT. 


COT’ND’ MEN’ ADOR 
The nenory address (region base) for this napped disc domain, if present. 


COT’NO’ DISCREG 

The disc request table index associated with this mapped disc donain. This 
will be used to fetch this region in, or to post this region after any logi- 
cal I/Oe (writes) have completed. (I.e., this ORQ is used for the physical 


CDT‘ ND’ LK’ CNT 
Wot used. 


COT’ MD’ LDEV 
The Ldev nunber for this napped donain. 


COT’ND’ IMPEDED 

The PIN for the first process inpeded on this napped disc domain. Processes 
get impeded here when they do WAITFORIO when thear LOR 18 on the COT impeded 
queue and the Mapped Donain is currently being written out. (This wall also 
happen upon a :STOPCACHE to force all LDORs to conplete.) fs soon as the 
physical post of the Mapped Donain is conplete, all processes inpeded here 
will be awakened. 


COT’ND’ DE 
The entry nunber for the Device entry that this Mapped Donain entry 18 as- 
sociated with. 
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21017 Pointer to Logical Dise Request Table 


NOTE: This table ie really part of the ORO (refer to Chapter 13). Any entry 
uath the logical request bit set in the flags will conforn to this for- 
nat and not the format of the standard ORQ. 


Logical disc requests entries are used to manage requests betueen the 
requesting process and a mapped disc donain. They are the counterpart of 
disc requests entries used to manage physical I/0 requests betueen a process 
and a disc. These entries are kept as part of the ORQ Table, but will never 
be queued to the disc's DIT, instead they uill be queued to the mapped disc 
donain COT entry. LDR entries nay only be placed onto the following queues: 


1. The COT active list. 

2. The COT ampeded LDR list. 

3. The Disabled Disc Request. (This will only happen if the buffer segnent 
us absent when the logical I/0 (cache nove) is attenpted. ) 


NOTE: LORs are singly linked onto the CDT queues and doubly linked cnto the 
disabled disc request queue. 
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LOR’ FLAGS 
Flags. 
(0:2) 
Not used. 
(2:1) - ORQR 
aa Set if LDR causes a physical 1/0. 


Set if request is to/fron a Systen Buffer. 
(43%) - JQUAKE. 
Set if systen should wake up the process 
when the logical 1/0 conpletes. 
(5:1) - BLOCKED. 
et if the process wants to wait for the 
(e:4) logical disc request to conplete. 
Set uhen the logical disc request is conplete 
and the process will be awakened (if IOWAKE is set) 
(7:1) = DO°POST. 
Set if the caller wants to be waited until the physical 
post to disc completes. Only valid for urite requests. 
(8:1) - SERIAL’ POST. 
et uhen the physical post should be 
through the Global Serial Write queue. 
(9:1) - CDI QUEVED. 
his request has been queued either 
onto the COT active queue (see CDT Napped Donain entries) or 
onto the disabled disc request list. 


(10:1) - ROVE’ DONE. 
he nove has been completed, but 


the process won't be auakened until the DONE bit is set. 
(11:1) - Not used. 


(12:1) - wie 
Set if this request is the current/active 
request. 
(13:1) - DISABLE. 
et if the request is disabled. 
(14:1) - LOR? REQ. 
Set af this is a logical disc request. 
(15:1) - LOR’ INLOC. 
Set if Mapped Donain COT entry is in 
process’s locality list. 


LOR’ L’HODA 
The High Srder Disc Address of the extent lint. 
(See note wath LOR’B'HODA, ) 


LOR’ LOEV 
The Ldev for this request. 


LOR COT 
The .cT nurber for the Mapped Donain entry aseociated with 
this request. 
LDR’ BUF LST 
Data Segnent nunber for the target of the Icgical 1/0 request. 
If bit zero is set, then this is the ante stack. 
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Leqica] Dise Request Entry 


042 324 5 6 7 8 9 1011 12 13 14 1§ 
ded ee ed edd pe bd be dod od De 
of {| 101 SI Zi el Of Of Si Ci mt [Cl Of Uf LiuoR'Fuacs 
1} | Ri} Bf Of LU] Of Of Ef OF OF | Ut TI O| MI 
1 | faluyworm) taitivi tRisirt | 
1 | PRieLarcrererzi ft t t fal yu 
i | Pel {Ki Kt | of al Qt of | Ri Bi RI Ol 
1 | Par ferel {si uur or | el ul el cl 
rid td Lor rte Pera! taper ar | 
rid eter et tt ber td porn 
a ed ed ed eed ed ed Pe ed Dd eo 
{| HODR OF EXTENT LIAIT | LOR’ L’ HOOR 
| eeeweneweeneccnccoweoenanswoooconne a aenccanasce 
a LDEV , | LOR’ LOEV 
3) MAPPED DOMAIN COT ENTRY NUMBER | LOR’ COT 
| a eee Ee 
4| S{ OST NUMBER | LOR’ BUF OST 
‘I OFFSET INTO DST | pie cees 
6| STRATEGY ! FUNCTION Jeans 
| cow n nnn nw eewnnooewenne | ome eor nnn nceeecooncoece 
7| COUNT/XLOG/CONTROL RETURNS | LOR’ COUNT 
10] P41 | LOR’ PARA 
ae P2 ; reves 
12] | QUALIFIER STATUS |LDR’STATQ 
13] PIN NUMBER |LDR’ PCS 
14) PREV. LOR IN QUEUE (TABLE RELATIVE) | LOR’ PREVO 
15| NEXT LOR IN QUEUE (TRBLE RELATIVE) | LOR’ NEXTO 
16{ ODA OF EXTENT BASE eek 
17| LOOR OF EXTENT BASE LOR’ 8’ LODR 
zi LOOR OF EXTENT LIAIT eer 
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LDR’ BUFROR 
Offset within the OST (above) for the target address. If the 
DST is the process’ stack, then this address will be D8 relative. 


LDR’ STRAT’ FUNC 
(0:8) - Strategy 
QO - Unknoun caller 
1 = Unknoun File Systen 
2 - Spooler 
3. - Directory 
4 - Dise Free Space 
§-7~ Unknown caller 
8 - GENNESSAGE 
9 - File Systen, Quiesce 1/0 
10 - File Systen, Sequential, No Buf 
11 - File Systen, Direct, No Buf 
12 - File Systen, Sequential, Buffered 
13 - File Systen, Direct, Suffered 
14 - File Systen, KSAN 
15 - File Systen, IMRGE 
(8:8) - Function 
0 - Read 
1 ~- Write 


LDR’ COUNT 

On initiation, this specifies the requested transfer count (*uords, -bytes). 
At conpletion of the request, this contains the actual transmission count 
(enords, obytes). 


LOR’ PARI 
Thas is the High Order Dise Rddress of the requested disc sector. 


LDR’ PARN2 
This ie the Low Order Disc Address of the requested disc sector. 


LOR’ STATQ 
Uniforn statue returns. 


LDR’ PCB 
PIN of the requesting process. 
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LOR’ PREVO 

Table relative index of the previous LOR in the queue. (NOTE: LDRs are sing- 
ly linked cn the CDT queues, and doubly linked on the disabled disc request 
queue). 


LOR’ NEXTQ 
Table relative index of the next LOR in the queue. 


LOR’B’ HODA 

The High Order Dise Address of the extent base. (Used uhen the logical disc 
request 18 through the file systen. Caching uses this data when searching 
nenory for a “hat” on a cached donain). 


LDR’8’ LOOA 
The Low Order Dise Address of the extent base. (See note above.) 
LOR’ L’ LODA 
The Low Order Dise Addrees of the extent linit. (See note above. ) 


6.23.00 
23- 19 


Native Language Support 
Nativ age Table (NLT 


This table is created by INITNLS (called by PROGEN). The OST nunber is con- 
tained in SYSGLOB extension 212. The Natave Language Table (NLT) contains 
the description of all the character sets needed to support the installed 
languages, and additional information needed to support the configured lan- 
guages (DST nunbers of the languages associated OSTs, character sets, etc. ). 


Every installed language has an associated Language DST, as set up by 
INITNLS. 


| | 
} NLT OVERHERD TABLE | 


| SSC C008 S48 220SS C8S8OSOSOOSO 


| NLT INSTALLED LANGUAGE | 
| TABLE | 


sSsuneoeeoeouoesea dO SOSSBSSSSESOSER | 


NLT INSTALLED CHARACTER | 
SET TRELE | 


ee ee | 
NLT CHARACTER ATTRIBUTE | 
TABLE | 


88 8 8898088985 CSS OORTTTSOS® | 


NLT Overhead Ta 


The NLT overhead table is eight (8) uords long. 


0] “ne Comes Ss | 

| oocceewerenenn | eonnenceonao-| 
" “yy | ow 
2| LENGTH OF NLT (IN WORDS) = | 


4| NUMBER INSTALLED CHAR SETS | 


S82 HOOSSSOSSEEESADSOESS oe ah aD ae aD: 


| 
S| SYSTEM LANGUAGE ID NUMBER 


6| SYSTEM LANGUAGE LDST | 
| NUNSER 
7| RESERVED | 
| eoenn enon ene we nnn eannweewnce | 
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CHAPTER 24 NATIVE LANGUAGE SUPPORT 
NL/3000 Internal Table Structure 


NLS FILE CODES 

LANGDEF.PUB.SYS  - 1228 
CHRDEFXX.PUB.SYS - 1229 
NLSDEF . PUB. SYS - 1229 


Native Lanquage Support (NLS) Table Overview 


| 

ISYS GLOG EXTN 212 |-- >| eee ee | 
SeecSerneneaees | | NATIVE | l | 
| | <-re-e-- >| LANGUAGE | 
| LANGUAGE | } OST { 
| [cween] | | 
| TABLE | 

| | 
[oeesoessesenese= | |. iUfsesscessecense | 
{| | 
|-->| LANGUAGE | 
| OST | 
| | 
|oocenennnosese | 
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24- 1 


Native Language Support 


NLT Installed Lanquage Table Fornat 


For each supported non-NATIVE/3000 languages there is a {2-uord language 


entry. 
eewewwenwewccowenecceccoeeoe | 
2 LANGUAGE ID NUNBER at 
1] LANGURGE CLASS | 
2 LANGUAGE LDST NUMBER | | 
| CHARACTER SET ID NUMBER | 
4| | ><1et SUPPORTED LANGUAGE 
{ ) | ENTRY 
” LANGUAGE NANE oi 
| (8 WORDS) 1 | 
| Z13]| \<--| 
| enn ann nnn nnn enn nnn nnn nn nene= | 
\ 1 
: | 
| LANGUAGE ID NUMBER hie! 
} LANGUAGE CLASS | 
al LANGUAGE LOST RUNPER | 
a CHARACIER SET ID NUMBER = | | 
4| | ><Nth SUPPORTED LANGUAGE 
| 1 | ENTRY 
” LANGUAGE NANE = 
(8 WORDS) it 
| 213] \<--| 
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Native Language Support 


NLT Installed Character Set Table Fornat 


For each character set installed on the systen there is an 11 uord character 
set table. It has the following fornat: 


| | 
O| CHARACTER SET ID NUMBER 


1| CHRRACTER SET TYPE | 
| SVS eeeese S222 e208 2eeee0 
2) POINTER TO CHARACTER | 
ATTRIBUTES TABLE 
! 
“ CHARACTER SET NRNE a 
j (8 WORDS) | 
| x12| | 
|--coenesennnnnnnnnnee secenee| 

6.23.00 
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Native Language Support 


Laneyace OST 


For each language installed on a target systen (uith the exception of 
NATIVE-3000) INITNLS will build one language OST with the followng 
structure: 





| 
| UST OVERHERD TABLE | 


i | 
| (DST TRANSLATION TABLES | 
| (5 SUBTABLES) | 


[ 
LOST CUSTOM DATA TRELES | . 


| 

| EE SE Gp Ok ee Eb EE Te a OT Bie Ee BP EY Sb OE GP ES Es GSD 
: UDST NATIONAL SPECIAL 
: TRBLE 
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Native Language Support 


NLT Character Attributes Table 


The NLT Character Attributes Table is comprised of a table for each con- 
figured character set. At this tine, only tuo character sets are configur- 
able: Class Four Languages (KANJI-based) and Nonclass Four Languages. 


CHARACTER TYPE = 1 





| 

| CHAR SET @ 1 |------------>| 256 byte | 
| ATTRIBUTES | | ATTRIBUTE | 
| -2----2-- eo n--- | TRBLE | 
| CHAR SET #2 [----| | owen enn n nnn wen nnenn- | 
} ATTRIBUTES | 

| enewennor ence nnn | CHARACTER TYPE = 2 
{ eanceanscwaceceocescce 
3 ne oo >| 8 WORD KANJI | 
| | | ATTRIBUTE | 
| -nnenneennnnnn-o-- | | TABLE | 


The type » 1 attribute table is a 256 byte table. Each byte corresponds to 3 
character with that octal value. 


Attribute 0 - Nuneric character 
1 - Special character (i.e., "'", "7", “.") 
2 - Alphabetic uppercase character 
3 - Alphabetic lowercase character 
4 - Control code 
5 - Invalid character (unused code) 
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Native Language Support 


LOST Overhead Table 


The overhead region has the fellowing fornat: 


| 
0 | ii) L* 


| 
{ oo | 
|----------- -+- |----n2-----=- | 
1 | *S" ! ogee | 
a LOST SIZE IN WORDS 
‘| NLT OST NUMBER | 
4| LOST OFFSET TO CUSTON | 
| DATA TABLES | 


| 
5| LOST OFFSET TO NATIONAL = | 
| SPECIAL TABLES | 


| é| I 
RESERVEO 
7j ! 


The national special table is optional. If it does not exist, the pointer to 
it is zero. 
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Native Language Support Native Language Support 


uence Table 


- (DST Translation Tables T atin 


The LOST Collating Sequence Table is of different fornats depending upon the 


For each language several translation tables are stored: 
class of the language. 


| LDST UPSHIFT TABLE | Overview 
{| (128 woRdS) 


| LOST OGUNSHIFT TABLE 
| (128 WORDS) 


| UST ASCII -> EBCDIC 
| CONVERSION TABLE 
| (128 WORDS) 


| UDST EBCDIC -> ASCII 
| CONVERSION TABLE 
| (128 WORDS) 


| LDST COLLATING 
| SEQUENCE TABLE 
| (CLASS CEPENDENT) 





Class One Sone languages, nanely Rnerican English and Katakana, can be be 

Lanquages: collated by using the nunerical representation of the ASCII en- 
coding as the sequence nunber for any given character. These 
languages can use the Conpare Bytes machine instruction. 


Class Tuo Sone languages may be able to use the COBOLIT machine instruc- 

Languages: tion, Conpare-Translated-Strings. These languages need to have a 
cne-to-one napping of character encoding te sequence nunber. Any 
algorithm for this class of language must take into acceunt the 
fact that not every HP 3000 has COBOLIT firnuare. 


Class Three Many languages will not be able to use either of the tactics 
Languages: described above. There are a nunber of language-dependent al- 
gorithns that need to be supported. 


Class Four Sone languages require 16-bit character string encoding. 
Languages: Collating these languages 1s not supported. The collating se- 
quence table for this class of language 18 reserved. 


ass On ngqua 


Since class one languages will use the compare bytes machine instruction 
(CRPB), the whole collating sequence table for this class 18 3 uords. 


0} 3 


| 
| 
1] LANGUAGE ID | 
| 
| 


2{ LANGURGE CLASS 
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Native Language Support Native Language Support 


Clase Tuo Languages 


Class Three Lanqua 








| 
| 12| RESERVED fences 


SOS ©8248 228 424888888 COSS8OS8SESHOSTS8 


| 
| 11] LOWEST CHAR. | HIGHEST CHAR. | 
| SEQUENCE VALWE ! SEQUENCE VRLUE 


| 13<--| SEQUENCE ENTRY # 0 ent 


This sequence table has a 13-uord over head table and a 128-uord sequence |----- wren ceneanseswcenseosocescess | 
table. O| TROLE LENGTH (WORDS) face 
Une eee oadecelonaweeueacewes | 
, | 1] LANGUAGE ID 
| 139 | : LANGUAGE CLASS | 

eeuedeulwciesaceusaeeceedeeseece qcacsconeeceecncccscessonscesnenn| 
y LANGUAGE ID ! | 11 | | 
2] LANGUAGE CLASS 4| 256 | 
BD Ei TD ER te Te le A ak OO ER > OP Oe a a ee ae Fe ib A AE SE AD Ph ae ee eee ER Hi ee Oe ae AG | 

4 1 | 5| POINTER TO 2:1 RAPPING TABLE | oes Table 
‘ 128 | 6| LENGTH OF 2:1 MAPPING TABLE | | 
miligicecaecoceunceconeessosensses géewewccsnpluetenescatacasecsude { 
| | 0 | cee table 7| POINTER T0 1:2 MAPPING TABLE | | 
ee OG ae wennnnnnenwennnem=| | 
‘| 0 | | 10| LENGTH OF 1:2 ARPPING TABLE 
?| 0 | | | 11] LOWEST CHAR. | HIGHEST CHRR. | | 
ee he ae | | | SEQUENCE VALUE | SEQUENCE VALUE | | 
| 10} 0 | Senos asecsessens cooweee | | 
| 
| 
| 
| 12| RESERVED |<----] | | SEQUENCE ENTRY @ 1 [ 
woceencenenceee= |oonone enero cena | [rceecerecccwnennrwenneennnennnnn= | >~Sequence table 

| ia SEQUENCE # 0 | SEQUENCE #1 |«----| | | | 
Keunacebonsuese lacunae wss caeesn<e ~ ss | 
| 14| SEQUENCE #2 | SEQUENCE #3 | | IE [aceeetetecatetatepstepatetabenetenenmatenstenenenaneeneneata | | 
peerreree ec iwr eee epee table | aM | SEQUENCE ENTRY @ 255 |[<----| 

rf , 1 | 2:1 CHARACTER ARPPING TABLE | 

| 212| SEQUENCE # 254 | SEQUENCE # 255 aa. | 1:32 CHARACTER MAPPING TABLE | 

ear 


Note: Word 211 of the overhead contains in the left byte the chare.ter 
value, which has the lowest sequence nunber and in the rignt by** the 
character value, uhich has the highest sequence nunber. 





In the 128-nord sequence table, the byte value of the character is 
used as a byte pointer in the collating table. 


The byte value of the character is used as a byte poicter coiseting 
entries. 
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s Th nquages (Cont. :1 Character Mapping Tab 
| 949919 
| | -----NODE------ | i 0123456789012345 
| y11401 [eeceecennnnncecenne] 0 [reeereneeseeeee | -nonen nen ennnne 
| 0123456789012394 , 2:1 MAPPING ENTRY |----> ‘ 0 LEGAL CHAR 1 | 
| sewn mescsccsajeseloccaccnoss=| # £ +#& = 3 &@©=©=—6d 6 000d feeesesessesssesses= ca eceseeeesosee | cocecwessocoos= 
| | 0 } 0 | 0 | These characters will 1] SEQ. OF PAIR | NODE OF PAIR | 
| |-neceweneonnnne|-ne|--seeeeen--| be ignored when sorted. seteesacet<ssse | cocerennnenenne | 
OR ‘4 
| 0123456789012345 | en woreceweenene | coccewwennn coon 
| | -onenn ene nneene [aoe lowereneecne| All 1:1 napping (W-1)*2] 0 | LEGAL CHAR N | 
| | SEQUENCE W | 0 | 0 | characters | --nnnnenneenne- | eoce none enenone | 
| | -ocoecenceeeene | of eononenenne | without case or (N-1)*201] SEQ.W OF PAIR | MODE OF PAIR | 
accent priority | or wennn nen ne wee | eomnnnnnn nena 
OR n*2| -4 | 
0123456789012345 Jaaanasessenssn- | aiwenssceeowiee | 
| Jorommn cnn nw once] one joocccecene=| 1:1 napping N*204| JMODE NON FATCH | 
| | SEQUENCE @ | 0 | PRIORITY | characters with | eonneeenenneone | conn rene weeenn- | 
I |oecocenewewnens [one |onen--------| case or accent 
priority 
OR | |on-nen-- NODE ---------| 
| 0123456789012345 
|--nn-----2----=|- we |ronnonn--e- l 0123.45 6 7 8 91011 1213 1415 
| SEQUENCE ® [1 | INDEX | 2:1 napping | ee fa ae Feed dd ed en eo ed ed 
| | porno nnn neon nn | coe | enewnnnnnee| characters | | 
| | -weoewnnerecnanccccoene Joro-- | eoorenneweowwncee | 
OR | | 
| 0123486789012345 | |o--re- INDEX/TYPE 
| |nenewennnnnnnna| oon |-nenenenene| | PRIORITY 
| S€Q. CF 1. | 21 INDEX | 1:2 napping | (BITS 10:6) 
| -nccccccencennn| oon |soecereeces| characters | 


(BITS 8:2) 
The byte value of the character is used as an index to the sequence entries. 


tntry has sane format as mode cpticns in the LOST Collating Sequence Table 
Fornat for Class Three Languages. 
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Native Language Support Native Language Support 
32 Char. e Napping 7 Clase Four Lanquages 
| 411994 
| 0123456789012345 Class four languages require 16-bit character encoding. Sorting in class 
sooecocececcccce -~-| | enncecccwoweens | ewecncooonceen- | four languages is not inplenented in this release of NLS. A preliminary col- 
ak RAPPING ENTRY |----> 0] SEQ.® OF 2ND MOCE OF BOTH | lating sequence table is planned to be 8 words in length. 
¥ SEQ.@ OF 2ND MODE OF GOTH | , 
! l ° RODRESS GN DISC - PATTERN 1 
| eorcecnccnccnes | cenneenennnnnee| 1| RDDRESS ON DISC - PATTERN 2 | 
N{ SEQ.@ OF 2ND | MODE OF BOTH | | 


|---e=== MODE --------| 
2345 6 7 8 9 10 11 12 13 14 15 


! Jo---]--|--|--t--}--1--1--1--]-- ee leefee o-|--| 


| 

|-----= INDEX/TYPE 
PRIORITY 
(BITS 10:6) 


wowceen- MODE TYPE (0,1, 0R 
(BITS 8:2) 


Entry has sane fornat as cne above. 
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Native Language Support Natave Language Support 








T Custcn Data Table Forna ST National Special Tab 
This table is 196 uords long. The formats and information in this table are This table is optional and its existence is signaled by a nonzero pointer in 
language dependent, and may be nodified with LANGINST. PUB. SYS. the LOST overhead region. It 18 used to store data unique to a given language 
(e.g. the Enperor data for the Japanese calendar). 
|----------2nna-ecnonownneen === | 
O| LDST CALENDAR SKELETON ty [peaesotenhasesteoecnn antes | 
| (9 WORDS) LENGTH 
| pucdeadeecdaaeelececesensewese eee eee eee ee 
11] LOST CUSTOM DATE SKELETON {9 | NATIONAL | 
{| (13 BYTES) | | DEPENDENT | 
| proee ene n owen newer wen enennenn= | } OATA | 
20{ UDST TINE SKELETON 116 | ewococewennmcerooceonnense | 
| (4 WORDS) 
24| LOST ABBREVIATED MONTH NAMES [20 
| (24 words) | Date Fornats for Japan and Taiwan 
[seeersesaccrs-sosesenasasersre= 1 
54| LDST FULL MONTH NANES j44 
} (122 WORDS) | For a given language, there is only one date format possible. The fornat of 
[saat eeer cco enseessanseeseeces= | the year stored in the date fornat of the LDST can either be yyyy or yy for 
164] LOST ABBREVIATED WEEKDAY NAMES|116 the Julian dates or Nyy for either the Japanese date (Emperor Era) or the 
| (21 BYTES) { Taiwanese date foundation of republic date). 
| -aeeeedseeaesensseesacesessocrr | 
177| UDST FULL WEEKDAY NANES \127 If the fornat of the year stored as the date fornat in the LOST is Nyy then 
| (42 WORDS) | either the Japanese enperor dates or the Taiwanese foundation date has to be 
| eoeeenenwnmcwwnncconecreneoncoe | stored in the national dependent table. 
251] LOST YES/NO CHARACTER STRINGS|169 
! (6 WORDS) 
257| DST THOUSANDS INDICATORS [175 
| (1 WORD) | 
260| LDST CURRENCY SYRBOL 1176 
(5 8YTES) | 
263| LOST RESERVED 1179 
6.23.00 6.23.00 
24- 16 24- 17 
Native Language Support Native Language Support 
National Dependent Table Fornats an te Forn 
| ---noronnnnn-------n0-- =| 
20] LENGTH OF TABLE(WORDS) | There are three entries which do not change. The user can add new entries. 
(ee These entries have to be stored in ascending order sorted by uord 1. 
x1 
| eewewwenennnnnanenennen== 
Z2| NUNBER OF ENTRIES The values of the entries are: 
%3| NUM GF HP SUPPLIED ENTR. | et Date Octal Value Starting Enperor Synbol 
[eneeecesenessssaecesere = | (MOY year 
44.425] PERIOD ENTRY 4 | 
 Ketetetetetetatatetetatetacatetananetearaietanen | & 1/ 1/1873 z1 741 ft 
a 7 7/0/1912 %14324 x1 T 
| ecoccer enn enec nn mnseennnn | 12/25/1926 132547 x s 
(2ne2) +| PERIOD ENTRY n | 
143) | eo nn wwe n none n nnn nnn ne----| 
* Since this starting tine is in the 19 th century and ue are not 
able to handle dates before 1900 easily, ue store Z1 as starting 
The period entries are tuo uord entries of the following fornat: tine. 
For new date entries created by the custoner the starting year 
0 67 1§ will aluays be 1. 
cebareeeese Jonnnnnnnnnnne 
| YEAR OF | ORY OF THE | WORD 1 (STARTING DATE) 
| CENTURY | YERR | 
cercecceses |-coreercen---| juan on 
0 78 1§ 
wenn sweeeeene | -----------| There are tuo entries for the Taiuanese national dependent table. 
| STARTING | EMPEROR | WORD 2 
| YEAR } sv"BOL | : The values of the entries are: 
[oaseese ssese= Jrorecenenee | 


Starting Date Octal Value Starting Emperor Synbol 
(nov) Year 
The ID for Japanese ard Taiuanese date fornats is aluays set to 1. 
1/ 1/1900 x1 20 240 
1/ 1/1912 214001 z1 24 


The user does not need to add new entries. 
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ATP/ATP37/ROCC 


CHAPTER ATP/ATP37/ADCE 


This chapter contains a description of the monitor/printer DIT and tables in 
the terninal data segnent (10S) used by the NPE V/E ATP/ATP37 and ADCC ter- 
ninal drivers. 


Terninal Data nent Fornat 


ATP/ATP37 Terninal Data Seqnent Fornat 


12 3 4 § 6 7 8 §Y 1 14 12 13 14 15 


42| TERMINAL DATA SEGRENT HEADER - 243 UORDS 


43] 
242] HARDWARE DIT POINTER TRBLE - Z200 WORDS 


646| VFC TABLE - 2404 WORDS 


| 
SS 9S OOS OS @ OC OS SESE SOE CSB OC OSS OS © OS 4 OSS © BSE 622EE6 EE BE SVSSOSSETEOOE | 
a7} | 


732| ATP HAROWARE OIT FOR UNIT O - X64 WORDS 


| 
PO OSG 0G24 OOSSE 2 2E OES S2E 8226248 42S06E8628 OS SOS COS SGSSO®e SE ES EE LG SO a ES AED EP A EM A ED ED OE | 
733] 


752| CONTROL PROGRAM AREA FOR UNIT O - 220 WORDS 


753) 
- 767| PROTOCOL AKD OATR RANRGER FIXED OIT FOR UNIT O - 215 WORDS 


770| 
1103] PORT PROTOCOL DIT FOR UNIT 0 - x114 WORDS 


1136] PROTOCOL AND DATA MANAGER VARIABLE DIT FOR UNIT O - 233 WORDS | 
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ATP/ATP37/ADCC 


ADCE Ternina) Data Seqnent Fornat 


7 8 9 1 14 12 13 14 15 


42| TERMINAL OATA SEGMENT HERDER - 243 WORDS 


431 


242| HAROUARE DIT POINTER TABLE - 2200 WORDS 


| ecewceeenewncennweennnnenneneneneoenenereoce ecoccccawsnessanens 
243] 
646] VFC TRBLE - 2404 WORDS 


a7] 


1010] AOCC HAROUARE DIT FOR UNIT 0 - £142 WORDS 


1011} 
1025] PROTOCOL AND OATA MANAGER FIXED DIT FOR UNIT O - 215 WORDS 


1141] PORT PROTOCOL DIT FOR UNIT O - 2114 WORDS ! 


1142) 1 
1174] PROTOCOL AND DATA MANAGER VAPIABLE DIT FOR UNIT 0 - 233 WORDS 


2080008 908 OOS 0808S © 6 08 8 06 08 OSS OOS © OBS OSS O 6 CBOSS OF OS SF BBOSEDOOOSOD | 


1175] ! 
1522] OIT’S FOR UNIT 1 - £326 WORDS 
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ATP/ATP37/ROCC 


ATP/ATP37 Terminal Data nent Fornat nt. 


1426] DIT’S FOR UNIT 1 - 2270 WORDS 


a2e2eae eee eee POP SOS SONS SS SBOE BOS OS © OOS BOS FO 2G BASH SSSSSESSESOBOLO® 


OOO OOS BF OOO 6 O84 464 OHS CFOS 24 SS OSE OFC BHASAS CS SSSS*STFVS BBFC BHQSSCSCTCSFO® 


| MESSAGE TABLE - 253 WORDS | 
| | 


| PORT ERROR DUMP ARER - 22424 WORDS | 


| TBUF*’S - 2105 WORDS EACH 


| SOOO BOO OBO OSC SSS 8B CBOSS BVSE BEES SSE €298SE 8 ES BESO DHHASSBSDOSSSOSSSECE 


Fixed overhead is 23760 words. Overhead per logical device is 2270 uords. 
Each TRUF is 2105 words. 


For ATP37s there is one data segnent created for each channel (DRT) that con- 
tains an ATP37. For ATPs there is at least one, maybe tuo data segnents 
created for each channel (ORT) that contains an ATP. devices confagured be- 
tueen units 0/47 are in one data segnent and if devices are configured be- 
tueen unite 48/95 they are in a second data segnent. The addresses for the 
data segnent(s) are contained in the first six words of the ILTX for the 
channel. If there is a second ATP data segnent then the data segnent address 
is in the second six words of the ILTX. 
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ATP/ATP37/ROCC 


Ternin Rn Forn 


| MESSAGE TRBLE - X53 WORDS 


oo 
| SOO OOS 2 GOGES OC © OOS OOS OO8 SSE OES OB 9BOS BOSS OSSSOSSHOOSOSSBRAASVSISS HHHEDS | 
Cad 


PORT ERROR OUMP RREA - X2424 UCRDS 


ED EP ED Gh ED OD AP PED PED 








| TUF TABLE HERDER - 212 WORDS 


| 
| T8UFS - £105 WORDS ERCH 





Fixed overhead is 23360 uords. Overhead per logical device is 2326 uords. 
Each TEUF is 2105 uords. 


For ROCCs there is cne data segnent created for all configured ADCC devaces. 
It will contain the tables for a maxinun of 64 configured devices. The ad- 
dress of the data segnent is in the firet six uords of the cLTX. 
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ATP/ATP37/AOCC 


Ternynal Data Seqnent Tables 


Terninal Data Seqnent Header Fornat 


012 3 4 § 6 7 8 9 10 11 12 13 14 15 


| 
ZO| TERMINAL DATA SEGHENT VERSION NUMBER 


| 
7{ DRT NUMBER OF CHANNEL - ATP/ATP37 ONLY | 


10| LOWEST LOGICAL DEVICE NUMBER IN TOS | 


11] HIGHEST LOGICAL DEVICE WURER IN TDS ages 
tal aIB POLL AAS. ATDVATP? NLS 
13] TOS RELATIVE POINTER TO MESSAGE TABLE Suen | 
tal Tos RELATIVE POTNTER TO PC OURP AREA - ATP/RTPOT ONLY | 


| 
15| TOS RELATIVE POINTER TO PORT ERROR oUNP AREA | 


| eee neewnnwnncewnnecnnn wen cnrennwennnececeenns wccncwwncccocons= 
20] STATUS WORD OF TOS WHEN IT WAS BUILT. - ATP ONLY 
21] STATUS WORD OF TDS WHEN IT WAS INITIALIZED - ATP ONLY | 


2OOS © BO 08S OS OSSSOE8 COS OS 8 £8 BSSSSSSSSSSSSSEESE S BEOBBESDDSDEOSOSSSTOSTSEOSS | 


22] STATUS WORD FOR DIAGNOSTICS | 





PP PED PP OPPS BPS SSS OSSSSSSSOSSSSS8S 2080 | 


23} | 
24| VERSION NUNBER OF LPNON 
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ATP/ATP37/ADCC 


AOCC Hardu T Pointer Ta Forn 


4 5 6 7 8 9 16 11 12 13 14 15 
ove es ed Pts ete pe eet De pee ee Do oo od Dg Do 


O| ORT NUMBER OF 1ST DEVICE 








| 
2] ORT NUMBER oF 2ND DEVICE | 


8 S82 6 BSC OS OS4E CFC 6 8S 0908S 28S OSS OSOSSE488EESSESE2SE8 OSE 28SESE8S8S8S8 E08 } 


3] TOS RELATIVE POINTER TO 2ND ADCC HARDWARE DIT | 


8 OO 8 OO SS SSO OOS 6 COSE 8 OF CSF © OS © 8 088S028 264 28 © SSS SSST 289888488208 ER82 | 


Seeeeeeecee PP OD OOD OPS OOPS O99 S OSE F88 OES SSE OOSSESESE8GEONSSE OSSOSTTHOETES | 


176| DRT NUMBER OF LAST DEVICE 


28 OSC OS OSS S CSS SS BSO OO 6 OES OOS BOSS8 SC O8OS OOS 4OSSE SSHSSSSESSOOSSESSE | 


177| TDS RELATIVE POINTER TO LAST AOCC HAROWARE OIT | 





csosnersasescsssnnaames | 


This table, words 243/Z242 in the data segnent, contains a data segnent rela- 
tive pointer to the hardware DIT for each device configured. The table also 
contains the ORT nunder of the device. If the device is not configured the 


pointer and ORT nunber will be a ninus one. 


VEC Table Fornat 


§ 6 7 8 9 110 14 12 13 14 15 


-1| VFC TABLE SIR 


SS O90 OC 0B 0 0 0 OSS OOO SO SO8S OS SE CESSES ODD ODSES OSSSDSSSSSASDOSHSHE“OEDS 


0! 
17] VFC ENTRY 0 


| BOOS 0080S OO OB 6 0 OSS 6 OS B © OHS SOSSS8 088 SSSSESE £8888 SE8 9SESE OSES OH OSSBODSSOOS 


4 
| 
| SO OOS S 8 688 O 8 OS SSS4 £OSE4OSE 9089 OSOOOSOSOSOSES OSES OBSSESOHEDNESESESOOSTO 
3601 
377| VFC ENTRY 15 


l ©0006 CO 6 COO 6 C8 6 OOO OO08 6 0888088988 2S 2899S E8808288SSSESSOSS2OS OS SS5HO8 


— ae RE IY SR TR --e we pe ee ee ee ee oe t+ me 


ATP/ATP37/ROCC 


Terminal Data Seqnent Header Fornat (Cont.) 


27| 
30| VERSION NUMBER OF PHYSICAL ORIVER - ATPDRIVER/ROCCORIVER | 


086 SOS 0080880806 CSS 8 0 OOO 6 OEOBEEDO8DOBS BEBO S OSS BOSSS BOSSES OBOOSCO 


Harduare DIT Pointer Table Fornat 


ATP/ATP37 Hardware DIT Pointer Table Fornat 


1 2 3 4 § 6 7 8 9 0 1% 12 13 14 15 


O| TOS RELATIVE POINTER TO ATP/ATP37 UNIT O HARDWARE DIT | 
1| TDS RELATIVE POINTER TO ATP/ATP27 UNIT 1 HARDUARE DIT | 
Pe | 
| 
171 Ts RELATIVE POOTER TO ATRIOS? OAT 27 MOURNE OTT 


This table, words 2743/2242 in the data segnent, contains 3 data segnent rela- 


tive pointer to the hardware OIT for each unat configured. 
not configured the pointer will be 2 minus one. 
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ATP/ATP37/ROCC 


VEC Entry Fornat 


6 7 8 § 10 11 12 13 14 15 
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o 1 2 3 4 § 6 7 8 § 16 11 12 13 14 15 


ol TERMINAL OST RELATIVE focuef Hs ee IT | 
"| porrstare _{TwPe {sec (196) | TWe.| | (KENFUS 
al cennzen Fait CHT | | S| RODEN SIOMMS STATE ! 
sl mnie atin I 


4| 26318 XON TINER 


| 
5| DATA SET READY TIMER | 


|--v--ccewecnonnnnennnccncanensnnnnnnncassennannnaces on nnenones 
6| DATR TERMINAL READY TINER | 


7{ PORT SPEED IN CHARACTER PER SECOND | 
10, TERRIMAL OST RELATIVE PUAT PROTOCOL OER , 
VGN ae Le ka, ton io 
{SIZIENS| PARITY] PARITY| ALT CHARS {FLO| | STATE \9 
iol time Sere Du cmaye- GENT) igugeuar 10 
131 DEFAULT TERMIWAL TYPE NUMBER’ | CURRENT TERMINAL TVPE NUMBER [11 
Uaineae e e he 
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PD’ CONTROLLER(1). (4:2) 
Indicates the type of controller. 
0 - Unused. 
1 - ATP, 
2 - rAoce. 
3 - Unused. 
PD’ SPEED’ SPECIFIED(1). (6:1) 
Indicates if the device is to be a speed-specified port. 


0 - Speedsensed. 
1 - Speed-specified. 


PD’ LINETYPE(1). (8:1) 
Indicates the type of line. Currently unused. 


0 - Asynchronous. 
1 - Synchronous. 


PD’ CONNECTTYPE(1). (10:2) 

Indicates the type of connection. 
© - Direct connect. Device configured as subtype O or 14. 
1 = fioden connect. Oevice configured as subtype 1 or 15. 
2 - Mocen connect. Device configured as subtype 9 or 13. 

This subtype 1s for CCITT type nodens. 
PD’ ERGKEN(1). (14:1) 
Indicates if the port is broken. 


© - Port is not broken. 
1 - Port is broken. 


FO" SQUERFAIL(1). (15:1) 
Indicates 1f a pover fail has just occurred. 


0 - No power fail. 
1 - F:wer faz] has just occurred. 
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WORD 0 
PO’ IOoITP 


Terninal OST relative pointer to the harduare OIT. 


WORD 1 
PO'PORTSTATE(1). (0:4) 


Indicates the current state of the harduare. This field is set after “start- 
ed" is returned fron the physical driver. 


0 - Unused. 

1 - Reading. The harduare is transferring data fron the 
device to main menory. 

2 - Writing. The hardware 18 transferring data fron nain 
menory to the device. 

3 - Idle read. The driver is doing a “dunny read” while 
waiting for the next operation. Only special characters 
will be processed. 

4 - Input save. The harduare is currently idle. The harduare 
is saving read characters to be processed against the next 
read, write or idle read. The Interrupt Manager cannot be 
called by the physical driver when in the input save state. 

- Unused. 

- Unused. 

- Unused. 

- Unused. 

- Selftest. The harduare is currently doing a selftest. 

O- Speedsensing. The hardware ie currently waiting to 

epeedsense the port. 

11- Set port protocol. The port protocol is currently being 
set up. This includes: 


XON/KOFF enable/disable 
7-bit/8-bit characters 

FF enable/disable 

Input parity enadle/disable 

Output parity type 

ENQ/RCK characters and block count 
Delay characters and delay count 
Linespeed 


12- Set special characters. The read, read secondary, 
write, and write edit special character sets are 
currently being set up. 

13- Moden control. The noden interface, input, and cutput 
control lines are currently being set up. 

14- Unused. 

15- Unused. 
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WORD 2 
PD’ CF*CNT(2). (0:6) 


Indicates the nunber of tines DCD has gone off during a read. This is incre- 
nented by the Interrupt Manager each tine there is a carrier fail during the 
read. If carrier fails nore that 50 tines during the read the noden will be 
disconnected. 


PD’ PENDING’ START(2).(7:1) 
Indicates if there is a fending request. 


0 - No pending request. 

1 = Indicates that a pending operation needs to be started 
by the physical driver. This oc:urs only on noden ports 
when the physical driver was in the niddle of processing 
a request and there was a carrier fail. The current 
request can not be started until carrier detect is back 
on. Pending is then returned to the P&D Manager. Once 
carrier goes back on the Interrupt Manager will start 
the pending operation. 


PO’ NODEN® SIGNALS(2). (8:8) 


Indicates the last known state of the moden input signals. A zero (0) indi- 
cates the signal is on and a one (1) indicates the signal is unused or off. 


Bit O - Unused. 

Bit 1 - Clear to send. 

Bit 2 - Signal qualaty. 

Bit 3 - Data set ready. 

Bit 4 - Call origin status. 

Bit § - Secondary carrier detect. 
Bit 6 - Ring indicator. 

Bit 7? - Carrier detect. 


WORD 3 
PO’ CFTIMER 
Contains a carrier fail tiner index. This is a X-secord tiner that is 


started by the Interruz* Hanoler when a carrier fail occurs. Tf carrier 
detect does not cone bacn an u:thin  seccnds the noden is disconnected. 
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WORD 4 
PO'XONTIRER 


Contains an XON tiner index. For term types 21 and 22 (HP 26318 processing) 
a 60-second tiner 1s started by the Interrupt Handler when the XOFF 18 
received. If the XON 18 not received within the 60 seconds the “LDEV NOT 
READY" message is printed by the Initiation Manager. 


WORD 5 
PD'DSRTIMER 


Contains a data set ready tiner index. If the port is to be speedsensed a 
2enunute tiner is started by the Interrupt Handler when OSR goes on. 
speedsense must then be conpleted urthin the 2-ninutes. If the port is being 
FOPEN'’ed then the tiner 1s started by the Initiation Manager. DSR and OCD 
must cone cn and the noden connected within the 2-ninutes. 


WORD 6 
PO’ DIRTINER 


Contains a data terminal ready tiner index. This is a S-second tiner started 
by the Initiation Manager when a moden is to be disconnected. OTR is driven 
low for 5 seconds to disconnect the noden. 


WORD 7 
PO’ PORTSPEED 


Indicates the current line speed in charactere-per-second. 


WORD 8 
PD’ PPROTOCOL 


Terninal OST relative pointer to the port protccol table. 


WORD 9 
PD’ CHARSIZE(9). (0:1) 
Indicates the size of the data character. 


0 - ?-bit characters with a parity bit. 
1 - 8-bit characters. 
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2 - Data set ready sensing for FOPEN. This is the sane as 
state 1 except that the port will be FOPEN’ed instead of 
speedsensed. 

3 - Data carrier detect sensing. The Interrupt Manager is 
waiting for OCD to cone on. DCD must cone on within 
30 seconds after OSR is on otherwise the noden will be 
disconnected. After OCD is on the port will be speed- 
sensed and the noden state will then be set to 5. 

4 - Data carrier detect sensing for FOPEN. This is the 
sane as state 3 except the port is being FOPEN’ed. 

5 - Speedsensing. The noden has been connected and a speed- 
sense has been started. 

6 - Connected. The noden is connected and the port has been 

successfully speedsensed if FOPEN’ed. If DCO goes off 

once the noden is connected it nust cone back on within 

3% seconds or the noden is disconnected. If DSR goes 

off the noden is disconnected. 

Disconnecting. The neden is being disconnected. The 

driver will drop DTR for 5 seconds. Then the noden 

state will go back to 1 or 2. 


~ 
‘ 


WORD 10 
PD’ OPORTSPEED 


Indicates the configured line epeed in characters-per-secend. 


WORD 11 

PO’ PPENTRYNUNS(11). (0:8) 

Indicates the tern type nunber ae specified in the 1/0 configuration. If a 
tern type file nane was specified instead of a nunber or there mas an error 
in trying to use the file none thie field will default to 31. 

PD’ TERNTYPE(11). (8:8) 

Indicates the current tern type nunder. If a tern type file nene is beng 
used this field will be a0. The current tern type nunber is tre one return- 
ed for FCONTROLs. 

UGRO 12 

PD HARDURRE’ TYPE 

A controller dependent word. For ATP it contains the cesults of the 


selftest. The contents of the word are the sane as HU'SELFTEST an the ATP 
physical driver DIT. For ADCC controllers the uord is uncsed. 
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PD’ PARITYENRB(S). (1:1) 
Indicates the state of parity checking. 


© - Parity checking disabled. 
1 - Parity checking enabled. 


PO’ WPARITY(S). (2:2) 
Indicates the type of parity generation for urites. 


© - Space, high order bit forced to zero. 
1 - Mark, hagh order bit forced to cone. 

2 - Even parity. 

3 - Odd parity. 


PO’ RPARITY(S). (4:2) 


Indicates the type of parity for read characters. Types are the sane as 
PD'’WPARITY. 


PD’ALL’ PARITY(9). (1:5) 

A reference to the above S5-bit parity field. 

PD’ ALTCHARSET(9). (6:3) 

Indicates the contents of the read alternate character set. 


0/2 - Unused. 
3 - Idle read set. 
4 - Transparent read set. 
5 - View read set. 
6 - Binary read eet. 
7 - Unused. 


PD'CLERRF(9). (9:1) 


Indicates if flow control waits should be aborted before the next write is 
started. Flow controls are aborted by the Inatiation Manager after break or 
subsysten break has been accepted by the nonitor. 


0 - Don’t abort any flow controls. 
4 - Flow controls should be aborted. 


PD’ MODEN’ STATE(S). (12:4) 
Indicates the current state of 2 noden. 


0 - Unused. 

1 - Data set ready aerated The Interrupt flanager is waiting 
for DSR to cone on. After OSR is on the Interrupt Manager 
will ay for OCD to cone on. The noden estate will then be 
set to J. 
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o 1 2 3 4 § 6 7 8 § 1 1 12 13 14 15 


0] SYS D@ RELATIVE POINTER TO LOGICAL MONITOR OTT eee me 
i| |RED|BRK| SS{SBF{ SBUFI |OSC] SBUF2 | ool | | 
| | LOPSTATE JECH|RED|GRK|RC | STATUSIDEV|STATUS |SRO|WUC| OC} 


[-=-| [=| 
2| HEAD TBUF POINTER / SYS BUF 1 POINTER / GANK NUMBER 


SSS OS BO © C6 0S C88 OO SF BOSSE SSO SOS SG O98 O © 8 BOOS © OS SS OS CS2SOS SOBSERSSSOSCO | 


3) TAIL TBUF POINTER / SYS BUF 2 POINTER / BANK OFFSET | 


_— | 
4| HEAD TBUFOFFSET / SYSBUF OFFSET / FROZEN DATA SEG OFFSET | 


OO SOO COO 6 6 O08 OOS OS 8OS OC OSS CSF 6S OS9SS OSS SF GSAS SSSSSSS9S S46 SSSSE88 








S| TAIL TAUFOFFSET / SYSBUF OFFSET | 
| aranxeD NUMBER OF BYTES TANRED FOR URITE peas 
\ inet He OME Sareea 
eo nen omenaRe | A 
| I0Q EOR CHARACTER | LFIREDIRED|RERD | EQFCODE [8 
wai Me cg 
nuit Teta te eee sere Ta 
satazulneulconfoneycnm{eiLissoicomtanxycatiunziecc) NN 
{TOP; LININCOINOD| SET | INGIENA|ENALERA|URI | TEF | XON| | 
Pe eg eat eer eee oe ge na a aaa OT 
avi mu me Oo Ns 
Jit Hoe en oe 
17] gexacnt © BROKEN RERD COUNT Sere ee eae 
el UCDO Mn Oe ee 
21| eles DISC ADDR / SWE “URIT” TDUF POINTER IY? 
a ‘Seescat Bris AeaD / TPS MUSE 
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nd Data Manager Variad T Format (Cont. 


“o 
o 


|- a: 
23| OPERATION ERROR - INTERRUPT MANAGER TO INITIATION MANAGER \19 


24|SUSICTLISPOIESCJOCZIMON|LBLIGLK] = | PEND 1318/BIN|LOG/20 
ILOP| X |SENJPAR|REDJUATINOD|NOD) | LOPSTATE |RSTINOD|DEV| 


25| READ TYPE | LLDAC JPRTIRED LOC! LAST LON OPCODE /21 
aol newesten oevite STATUS 
27| OLD TRANSFER COUNT / STATUS URITE COUNT eel re 
yo] POINTER To SED EOF TUF SSS \24 
at| count OF bata In SaveD tor TWF 
i 

WORD 0 

PD’ LOMDIT 


SYS DB relative offset to the logical device nenitor DIT. 


WORD 1 
NOTE: 


This word is write shared betueen the Initiation Manager and Interrupt 
Manager. When the Initiataon Manager is modifying this word the interrupt 
systen should be off. 
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PD’ NO’ READECHO(1). (4:1) 
Indicates the current state of echo. 


© - Echo is enabled. Echo nay be enabled by an 100 function 
code of 8 (FCONTROL 12) by the Initiation Manager 
an "ESC senicolon” fron the device by the Interrupt 

anager. 

1 + Echo is disabled. Echo nay be disabled with an 100 
function code of 9 (FCONTROL 13) by the Initiation 
Manager or by an “ESC colon” fron the device by the 
Interrupt Manager. 


PD° BREAX(1). (5:1) 
Indicates if break has been detected. 


0 - Break has not been detected. 

1 - Break is enabled and has been read. This is set by 
the Interrupt Manager when break is detected and cleared 
by eee flanager when break has been accepted or 
rejected. 


PO* SSBRERK(1). (6:1) 
Indicates if subsysten break has been detected. 


© - Subsysten breek has not been detected. 

1 - Subsysten break is enabled and has been detected. This 
is set by the Interrupt Manager uhen the subsysten break 
is read and cleared by the Initiation Manager when the 
subsysten break is accepted or rejected. 


PD’ SBUFRERDCONP(1). (7:1) 


Indicates if softuare ie currently processing a read byte count exhausted in- 
terrupt for a spooled read. 


© - Read conplete interrupt is not currently being 
processed for a spooled reed. 

1 - Read conplete is currently being processed for a 
spooled read. 


PD’ SOUFI’STAT(1). (8:2) 


If the current read is using systen buffers this field contains the status of 
one of the tuo systen buffers used for the read. 


0 - Enpty. Available for the read. 
1° Pilling. Currently tt used for the read. 
2 - Full. The buffer is full. 
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PD’ LOPSTATE(1). (0:4) 
Indicates the current logical operation state of a request. 


0 - No operation. The driver has finished a request and 

is waiting for the next request. 

Reading. 

Writing. 

Status request to a device. The driver 18 currently 

writing a status request sequence to an HP 26316 printer. 

- Status read. The driver is currently reading status 

back fron an HP 26318. 

Control-X response. The driver is currently urating 

the "!!!,er,1f" after receiving the Control-X. 

6 - Waiting for a carriage return. The driver 1s currently 
waiting for a carriage return to start or terminate 
a block node read. 

7 - Urite with pending read. The driver is currently 
uriting and at the completion of the urite a read 
should be started. 

8 - Harduare setup with pending read. The driver is 
currently setting up the harduare and uhen done it should 
start the pending read. 

9 - Write with pending status request. The driver is 
currently uriting and at the conpletion of the write 
should request status fron the HP 26318 printer. 

10- Speedsensing. 

11- Set port protocol. The driver is currently setting up 
the current port protocol. This will include: 

- Enable/disable ENQ/ACK handshake 
- Enable/disable XON/XOFF handshake 
- ENQ/ACK handshake characters 

- ENQ/ACK block count 

- Delays for CR, LF, and FF 

12- Set special characters. The driver currently setting 
up the read, the read alternate, the urite, and the urite 
edit special character sets. 

13- Moden control. The driver is setting up the noden 
logic and 18 waiting for the noden signals to go to a 
known state. 

14- Freezing. The driver is waiting for the users stack to 
be frozen before starting the current read. Not 
currently used. 

15- View read set up. The driver is writing out the 
sequence to hone the cursor and lock the key board before 
starting the current read. 


1 
2 
3 
4 
5 
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PD’ DISCNCT’ DEV(1). (10:1) 


Indicates that the port is being disconnected so sone error conditions will 
be ignored while this is taking place. 


0 - No disconnect in progress. 
1 - Disconnect in progress. 


PD’ SBUF2°STAT(1). (11:2) 


If the current read is using systen buffers this field contains the status of 
the second of the tuo systen buffers used for the read. 


0 - Enpty. Available for the reed. 
1 - Falling. Currently being used for the read. 
2- Full. The buffer is full. 


PD’ OO’ STATREQ(1). (13:1) 


Indicates if an HP 26318 status request should be done after all the data 
tanked for the urite has been uritten out. 


0 - Don’t request printer status. 
1 - Request printer status at conpletion of the urite. 


PO* uu (1). (14:1) 

If set then the write is a non-critical urite and logicel device monitor is 
auakened at the conpletion of the urite. The bit is set by the Initiation 
Manager and cleared by the Interrupt Manager. 

PD’ LOPCONPLETE(1). (15:1) 

Indicates if the current Jogical operation is conplete. 


© - The logical cperation is not conplete. 

1 - The logical operation is complete. Set by the Interrupt 
Manager at the end of the operation, i.e., read is 
complete. The logacal monitor is then awakened and 
notified the operation is conplete. 


WORD 2 

Thais word contains an address for the current data transfer. There are three 
lypes of cata trarsfers with the current type indicated an PD’READ’LOC. The 
type of \rensfer indicates the type of address. 


PD’ HEADTBL'F 





A TOS relative printer to the “ead “BUF. 
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PD’ SBUF 1 

A SYS DB relative pointer to a systen buffer. Systen buffers are used for 
spooled reads uhere the transfers are done in disc sector sizes (128 words). 
There are tuo systen buffers used, the second in PO'’SBUF2, for the read. 
When one becones full the second one 1s used while the Initiation Manager 
transfers the data fron the buffer to the disc. This suing buffer process is 
done until the read 18 conplete. 

PO’ BRNKNUNB 


Contains the bank nunber of the data seqnent used for frozen reads. 


WORD 3 

This word contains an address for the current data transfer. There are three 
types of data transfers with the current type indicated in PD’RERD’LOC. The 
type of transfer indicates the type of address. 

PD’ TAILTBUF 

A TOS relative pointer to the taal TBUF. 

PD’ SBUF2 


A SYS 0B relative pointer to a systen buffer. See PD’SBUFI for information 
on how systen buffers are used. 


PD’ BANKOFFSET 


Contains the offset into a bank of the data segnent used for frozen reads. 


WORD 4 

PD’ HERDOFFSET 

Contains a byte offset into the head TBUF or systen buffer. For reads this 
is an offset to the first byte read. For urites this 18 an offset to the 
next byte to be written. 

PD* RBSOFFSET 

Contains an offset into the frozen data segnent of where the spooled read 
data should be saved. 

WORD § 

PO’ TAILOFFSET 

Contains a byte offset into the tail TBUF or systen buffer. For reads this 
offset is to the last byte read. For urites this is an offset to the last 
byte to be written. 
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PD’ BINARYRERD(8). (11:2) 
Indicates if the read is a binary read. 


0 - The read is not binary. 
1 - The read is a binary read. 


PD’ EOF (8). (13:3) 
End-of-file code. Not currently used. 
PO’ REROF LAGS 


A reference to all of the above fields. 


WORD 9 

PO’ ALTEOR(9). (0:8) 

Contains the EOR character as specified in FCONTROL 41. 
PO’ RLTSSBREAK(9). (8:8) 


Contains the alternate subsysten break character. The alternate subsysten 
break character is not deleted fron the read when detected. 


PD’ TRANSPRRENT 


A reference tc both alternate characters. If non-zero then the read is knewn 
38 a transparent read. 


PD’ ALTCHARS 


A reference to both alternate characters. 


WORD 10 

PO’ LASTEGR(10). (0:8) 

This contains the last EOR character. When EOR characters are to be changed 
by the Initration Manager this field wall indicate if a physical change 
should be done, i.e., if the new EOR and clo ENR are ine sane. 

WORD 11 

NOTE: 

This is a write only uord for the Iritistion Manager. The Interrupt Manager 


should not urite to any (used or unusec) fie:zs as 1t nay Cévse software 
problens. 
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WORD 6 
PO’ BTRNKED 


This indicates the nunber of bytes that have been tanked into the TBUF for 
the write. If -1, then all bytes have been tanked. The Initiation Manager 
wall tank up to a naxanun of 5S TBUFs of urate data before the write is start- 
ed. As each TBUF 18 enptied the Interrupt Manager will restart the write. 
When there are 2 TBUFs left the Initiation Manager is notified and the tank- 
ang will resune, while the last tuo TBUFs are being enptied. This continues 
untal all the data has been tanked by the Initiation flanager, and all the 
data uritten cut by the Interrupt Manager. 


WORD 7 


PO’ READCNT 


This indicates the nunber of bytes for the current or pending read. 


WORD 8 

PO’ IOQEOR(8). (0:8) 

Contains the end-of-record character in the current read 100. 
PO'NOLF(8).(8:1) 

Indicates if a LF should be sent out at the end of the read. 


© - Send a LF when the read is terminated by an EOR character. 
1 - Don’t send a LF when the read is ternanated by an EOR 
character. 


PD’ VIEWREAD(8). (9:1) 
Indicates if the current read is a View read. 


0 - The current read is not a View read. 

1 - The current read is a View read. When a OC2 is 
received the Interrupt Manager will urate cut the 
sequence to hone the cursor and lock the key board. 


PD’ OUNREAD(8). (10:1) 
Indicates if special processing is done on OC2s received during the read. 


0 - 0C2 characters are processed “normally”, and will start 
block node transfers. 

1 - D0C2s don’t start block node transfers and will be saved 
as nornal read data. 
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PD’ NEWTOP(11). (0:1) 
Indicates if the device is at top of forn. 


0 - Device is not at top of forn. 
1 - Device is at top of forn. 


PD’ NEWLINE(11). (1:1) 


Indicates if the device carriage is at the beginning of a new line. Note 
that this field 18 currently unused. 


PD’ CONSHODE(11). (2:1) 
Indicates if the device is currently in console node. 


0 - Device is not in console mede. Console node can be 
cleared with an I0Q function code of 31 by the 
Initiation Manager. 

1 - Device is in console node. Console node can be set 
uith an 10Q function code of 31 by the Initiation 
Manager. 


PD’ BRERKNODE (11). (3:1) 
Indicates if the device is currently in breaknode. 


0 ~ Device not in breaknode. Cleared uith an IGQ function 
code of 3% by the Initiation Manager. 

1 - Device is in breaknede. Set with an I0Q function code 
code of 3% by the Initiation Manager. 


PO’ CHARSET(11). (4:1) 
Indicates what read special character set is currently being used. 


0 - Secondary. 
1 + Prinary. 


PD’ FILLING(11). (5:1) 


Indicates if the Initiation Manager is currently active and filling a urite 


0 - Not eine: 
1 - Filling. This is cleared after the TBUF has been filled 
and linked into the tail of write TEUFs. 
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PD’ SSBRKENAB( 11). (6:1) 
Indicates if subsysten break is enabled. 


© - Subsysten break is disabled. Subsysten break is 
disabled with an I0Q function code of 12 (FCONTROL 16) 
by the Initaation Nanager. 

1 - Subsysten break is enabled. Subsysten break is enabled 
with an I0Q function code of 13 (FCONTROL 17) by the 
Initiation Manager. 


PO’ CONSENAB(11). (7:1) 
Indicates if the console interrupt is enabled. 
© - Console interrupt is disabled. This is disabled with 
an I0Q function code of 38 by the Initiation Manager. 
1 - Console interrupt is enabled. This 18 enabled wath an 
100 function code of 38 by the Initiation Manager. 
PO’ BREAKENAB(11). (8:1) 
Indicates if break is enabled. 


0 - Break is disabled. Break is disabled with an I0Q function 
code of 10 (FCONTROL 14) by the Initaation Manager. 

1 - Break is enabled. Bresk is enabled with an I0Q function 
code of 11 (FCONTROL 15) by the Initiation Manager. 


PD’ CRITICALW(11). (9:1) 
Set by the Initiation Manager if the write is a critical write. At the con- 
pletion of the urite the logical device monitor is auakened and cleared by 
the Initiation Manager. 
PO’ MATTFORTSUF (11). (10:1) 
Indicates if the driver is currently waiting for a TBUF. 
0 - Not waiting for a TBUF. 
1 - Driver is waiting for a TUF. This is set uhen the 
driver requests a TEUF and one is not available. See 
PO’DEVLINK for a complete explanation of when and hou 
the driver gets TBUFs that are not available. 
PD’ PCC’ KON’ NOFF(11). (11:1) 
Indicates if the hardware will do the XON/XOFF handshake. 


0 - The P&D driver will handle the XON/XOFF handshake. 
1 - The hardware will handle the XGN/XOFF handshake. 
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WORD 15 
PO’ BROKRCNT 


Contains the byte read count of the broken read. 


WORD 16 
PD’ DEVLINK 


Contains a TDS relative pointer to the next device waiting for a TBUF. The 
pointer is to the P&D variable DIT. Uhen the driver can’t get a TBUF it will 
set PO'MAITFORTBUF, indicating it is waiting for a TBUF. In the TDS header 
(TOS’UAITHERD'P and TOS’WAITTAIL’P) there is a linked list of devices waiting 
for TBUFs. Again the list points to P&D variable DITs. The driver will then 
link its variable DIT to the tail of the list. As TBUFs becone free, 
RETURNLYNXBUF will give the TBUF to the device at the head of the list and 
then auaken the driver, The new TSUF pointer is placed, by RETURNLYNXBUF in 
PO'TBUFWAIT in the variable DIT. 


WORD 17 

PD’ TBUFWAIT 

Contains a TBUF given to the driver (by RETURNTBUF) that was waiting for a 
TBUF. See PD’CEVLINK for a complete explanation of uhen and how the driver 
gets TEUFs that are not available. 

WORD 16 & WORD 17 

PO’ DISCRDOR 


Contains a dise address for spooled reads. 


WORD 18 
PD’ XFERCNT 


Contains the current count on the nunber of bytes read if currently reading. 
This count 18 only updated when the read is interrupted (i.e., TE.F becones 
full or read special character) and is conplete or has to be restarted. 


PO’ TBUFS’ IN’ USE 


A count on the nunber of urite T8UFs currently in use. Esch tine the 
Initiation Manager fills a TBUF this count is increnented. fs the Telfs be- 
cone enpty the Interrupt Manager will decre~ent this count. bien cre Count 
ets to 2 and there is still data to be tankeo (PD’BTANKES <> -1) then the 
itiation Manager is awakened to resune tanking. 
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WORD 12 
PD’ RERDTINE 


Contains the conputed read tine, in 1/100ths of a second of the last tined 
read. Thais is returned to the caller with an FCONTROL 18. 


WORD 13 
PD’ TININGREAD(13). (0:1) 
Indicates if the next read tine is to be calculated. 


0 - Don’t conpute read tine for next read. Cleared with an 
100 functacn code of 16 by the Initiation Manager when 
the next read is started. 

1 - Conpute read tine for next read. Set wath an [00 function 
code of 17 by the Initaataon Nanager when the next 
read is started. The conputed read tine 1s placed in 
PD’READTINE by the Interrupt Manager. 


PD’ ROTIMEQUTVAL(13). (1:15) 

Contains a read tine out value in .1°s8 of seconds if the next read is to be 
tined. This 18 set wath an FCONTROL 5 by the Initiation Manager when the 
next read is started. 

PO’ PRERDTINING 


A reference to the above read tining infornation. 


WORD 12 & WORD 13 
PO’ RDSTARTINE 


For reads that are to return a computed read tine this double word will con- 
tain the read start tine. This is initially set by the Initiation Manager 
uhen the read is started. When the read 18 complete the Interrupt Manager 
places the conputed read tine in PO’READTINE. 


WORD 14 
PD’ BRKTEUF 


Contains a TOS relative pointer to the head TBUF of the broken read data. 
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WORD 19 
PD’ ERROR 


Contains an error coded for the current transfer. This is a connunication 
uord used by the Interrupt Manager to pass informaticn to the Initiation 
Manager. 


1 - No systen or terminal buffer available to restart the read. 
2 - Overrun error. 

3 - Franing error. 

4 ? Unused. 

5 - Parity error. 

6 - Unused. 

? - Roden error. 

8 - Unused. 

9 - Unused. 

10 - A type 2 EOR has been detected. 


WORD 20 

NOTE: 

Thie is a write only word for the Interrupt Manager. The Initiation Manager 
should not write to any (used or unused) fields as it nay cause softuare 
problens. 

PO’ SUSPLOPSTATE(21). (0:1) 

Set if a logical operation has been suspended that uill resune later. 

PD’ CNTRLK( 20). (1:1) 


Indicates if the Control-X response should be sent when 2 Control-K is 
received. 


0 = Don’t send the Control-X response. The Control-X response 
is disabled with an 100 function code of 27 by the Initiation 
Ranager. 

1 - Control-X response is enabled. The Control-X response is 
eat with an 10Q function code of 26 by the Initiation 
anager. 


PO’ SPDSENSE( 20). (2:1) 
Indicates if the device has been epeedseneed. 
0 - The device has not been speedsensed. 


1 - Set by the Interrupt Nanacser after a successful 
speedsense. 
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PD’ ESCPRIR(20). (3:1) 


Indicates if the driver is in the niddle of processing an ESC sequence to 
maybe enable or disable echo. 


© - Not processing an ESC pair sequence. 

1 - Driver is currently processing an ESC pair. Set by the 
Interrupt Ranager when an “ESC special character is 
detected. fi one-byte read is then started to determine 
if echo should be changed. 


PD’ OC2READ( 20). (4:1) 
Indicates if a OC2 was read during the current read. 


0 - DC2 has not been read. 

1 - DC2 has been read. Set by the Interrupt Manager and 
indicates that the read is a View read, blocknode or 
linebleck node read. 


PD’ XONWAIT(20). (5:1) 


Indicates if the driver has read a DC3 (XOFF) and is waiting for the 0C1 
(XON). Note that this 18 only used when the driver processes the XON/XOFF. 
The hardware may actually do the XON/XOFF processing and the device may be in 
an XOFF state and this bit may not be set. 


© - XOFF has not been read. 
1 - XOFF has been read. 


PD’ LBLOCKNODE (20). (6:1) 
Indicates if the current read is a line block node read. 


0 - The current read is not a line block node read. 
1 - & OC2,CR has been read and the read is a line block 
nede read. 


PD’ BLOCKNODE (20). (7:1) 
Indicates if the current read is a block node read. 


© - The current read is not a block node read. 
1 = A OC2 has been read and the read is a block node read. 


PO’ PENDLOPSTATE (20). (9:4) 


This field contains the old logical operation. This is used when an event 
occurs (1.e., moden interrupt) that results in a new sequence or logical 
operaticns before the old one can be resuned. 
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PO’ LLONC(21). (4:3) 
Contains the last logical device nonitor call to the Initiation flanager. 


0 - Unused. 

1 - Set device characteristics (IN’SET’ OEY). 
2 ~ Read (IN’READ). 

3 - Write (IN WRITE). 

4 - Abort call (IN’ ABORT). 

S - Refuse call (IN REFUSE). 

6 - Device control call (IN’DEV’CONTROL). 

7 - Unused. 


PO’ PRINTER(21).(7:1) 

Set aif logical device is a printer. 

PO’ RERDLOC (21). (8:2) 

Indicates where the data is going for the current read. 


0 - Unused. 

1 - TBUFs are being used for current read. 

2 - Systen buffers are being used for current read. 
3 - Read data is going to a frozen data segnent. 


PO" LONOPCODE (21). (10:6) 


Contains the opcode of the last call by the monitor to the Initiation 
Manager. PO'LLDNC will indicate the last Initiation Manager call. 


Opeodes for calls to IM’ SET’ DEV: 


0 - Partial conpletion. Initiation Manager should 
continue with old operaticn. 

1 - Return device characteristics. 

2 - Set a new tern type. 

3 - Change parity. 

4 - Change the echo flag. 

§ - Change transparent read special characters. 

6 - Enable/disable subsysten break. 

7 - Enable/disable break. 

8 - Enable/disable Control-fA. 

9 - Set/clear console node. 

10- Set/clear console node. 

11- Set data Length. 

12- fisconnect. 

13- Enable/cisable Control-K reply. 

14- Har.gup tineout. 

°S- Selftest. 

6 - Wart for current operaticn to conplete. 

7 - Flush broke~ read TBUFs. 

8 - Disconnect innediately. 
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PD’ 26318’ RESET(20). (13:1) 


Indicates if the HP 26318 is initially being reset. This 18 used to prevent 
bad status reports between FOPEN’s, etc., that may occur when the printer 18 
being reset. 


0 - HP 26318 not being reset. 
1 - HP 26318 beang reset. Ocn’t report any transfer errors. 


PD’ BINARY’ AODE(20). (14:1) 
Indicates if in binary node. 


0 - Not in binary node. 
1 - Binary node enabled. 


PO’ LOGONDEV(20).(15:1) 
Indicates if the devace is a logon/speedsense device. 


0 - The device is not a logon device. 
1 - The device is a logon/speedsense device. 


WORD 21 
NOTE: 


This is a write only word for the Initiation Manager. The Interrupt Manager 
should not urite to any (used or unused) fields as it may cause softuare 
problens. 


PO’ READTYPE(21). (0:4) 


This indicates the type of read that is currently active. This is set by the 
Initiation Manager and not changed until the read is logically conplete. 
Different read types are: 


0 - No operation. 

1 - Character node/block node read. 

2 - Spooled read. 

3 - Idle read. 

4 - Transparent character/block node read. 
5 - Vieu/300 read. 

6 - Binary read. 

7 - Not used. 
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Opeodes for calls to IM’ READ: 


0 - Continue current operation. 

1 - TOUF read. 

2 - Frozen stack read. Not used. 
3 - Speoled read. 

4 - Speedsense request. 

5 - Read tineout. 

6 - New read request. 

7 - Start pending read. 

8 - Break accepted. 

9 - Subsysten break accepted. 


Opcodes for calls to IM’ URITE: 


0 - Continue current operaticn. 

1 - Tank data. 

2 - Tank token. 

3 - Start write. 

4 - HP 26318 status request check. 


Cpcodes for calls to IM’ RBORT: 


0 - Unused. 

1 - Halt all 1/0. 

2 - Abort current operation and start idle read. 
3 - Hard preenpt. 

4 - Soft preenpt. 

5 - Break accepted. 

6 - Subsysten oreak accepted. 


Opcodes for calls to IM’ REFUSE: 
0 - Unused. 
1 - Break refused. 
2 - Subsyeten break refused. 
WORD 22 
PD’ STATUS 
Contains the etatus byte returced fron an HP 26318 printer. 
Bit 4 - If set then a trans‘er errer occurred. 
Bit 5 - If set then the device is offline. 


Bit 6 - If set then the device buffer is full. 
Bit 7 - If set then the device is out of paper. 
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WORD 23 

PD’ OLDXFERCNT 

Indicates the nunber of bytes read up to the last back space. Needed so the 
successive LF’s are not output on devices that required a LF in response to a 
BS. Set and cleared by the Interrupt Manager. 

PD’ STATUS’ WENT 


Contains the write count for a HP 26318 status request. 


WORD 24 
PO EOF TBUF 
Contains a TOS relative pointer to the saved EOF TBUF(s). 


WORD 25 
PD’ EQFCNT 
Contains a byte count of saved EOF data in PO’ EOFTBUF. 


WORD 26 
PD° READTINERINDEX 


fi tiner index for reads that are to be tined. 
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WORDS 0/11 


Contains a file nane of the terntype file. 


WORD 12 
PP’VFC 
Terninal OST relative pointer to a VFC entry in the VFC table. 


WORD 13 
PP* ECHO. (0:1) 
Indicates the initial state of echo. 


0 - Echo is disabled. 
1 - Echo is enabled. 


PP’ ENQRCK. (1:1) 
Indicates if the device dees ENO/ACK handshaking. 
- ENO/ACK handshaking is disatled. 

: ~ ENQ/ACK handsiaking is enadled. PP’ ENQCHAR and 
PP*ACKCHAR wall contain the ENQ/ACK character and 
PP’ENQBLOK will contain the tlock size. 

PP’ DELAY. (2:1) 
Indicates if delays should be enat-ed. 

0 - Delays are not enadled. 

1 - Delays are enabled. PP'DELSYCR, PP’DELAYLF and 
PP’DELAYFF will contain the delay anount in 10ths of 
seconds. 

PP*XF LOW. (4:1) 
Indicates if KON/XOFF handshaking should be enabled. 


© - XON/XOFF handehaking is disabled. 
1 - XON/N2FF hands!.aking is enabled. 


PP'XSTRIP. (5:1) 
Indicates af the \Gh/XOFF should be stripped. 
© - The XOn,/XOFF shouid not be stripped fron read data. 


1 - The KON/‘SFF wail be stripped fron read data if 
handshahes are dic-dled. 
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Port Protocol] DIT Format 


9 10 11 12 13 14 15 
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PP ENSTRIP. (6:1) 


Indicates if Control-Y should be stripped. 


0 - Centrol-Y should not be stripped fron read data. 
1 - Contrel-¥ will be stripped fron read data. 


PP’ CONS’ STRIP. (7:1) 
Indicates if Control-A should be stripped. 


0 - Control-A should not be stripped fron read data. 
1 - Control-f will be stripped fron read data. 


PP*FFOK. (12:1) 
Indicates if FF should be alloued as cutput. 


Q - The FF should be replaced by PP’FF’NEWCHAR. 
1 - The FF are valid. 


PP’ 0C3° CONTROL. (13:1) 
Indicates if a DC3 should be appended to write data after each CF, LF. 


© = Don’t append any 0C3s to write data. 
1 = Append a 0C3 following the CF, LF. 


PP’ BLOCKNODE. (14:2) 
Indicates the type of blocknode read to do on DC2s. 
0 - Mone. 
1 - Line blocknode. 
2 - Page blocknode. 
3 - Either line or page biocknode. 
WORD 14 
PP’ DO’ XON’ TIMER. (0:1) 
Indicates if the driver should start an ¥On tiner after an OFF is received. 
0 - Don’t start an XON tiner if an XGFF is received. 
1 - Start an XON tiner, indicated by /P’XON’ LINE 
if an XOFF is received. 
PP°URITESTATUS. (1:1) 


Indicates if a status request, “ESC70C1", should be uritten to the device. 





© - Don’t request status fron the device. 
1 - Send a status request to the device. 
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PP’ 26318’ FIX. (2:1) 


Indicates if status should be requested fren the device after an XOFF even 
though PP’URITESTATUS nay be set. 


© - Don’t uorry about when the status request is sent. 
1 - Don’t request status as the XOFF was received in the 
niddle of a line and we don’t want to possibly send 
an ESC sequence in the niddle of a user ESC sequence. 
PP’ INIT’ DEV. (3:1) 
Indicates if an initaalization sequence should be sent to the device. 


0 - There is no initialization sequence. 
1 - There 18 an initialization sequence. 


PP*VFC’OK. (4:1) 
Indicates if there is a VFC file for the device. 


© - There 1s no VFC file to send to the device. 
1 - There is a VFC file for the device. 


PP* CHAR’ SIZE. (5:3) 


Indicates the size of the data characters. The value 1s 1 less than the ac- 
tual character size, 1.e., 8-bit data will be indicated by a 7. 


PP’ FF*NEWCHRR. (8:8) 


Contains the replacenent character for FFs if FFs are to be replaced. 


WORD 15 
PP’ NAME VALID. (0:1) 
Indicates if the tern type file nane is the current tern type. 
0 - The current tern type is specified by a nunbered 
tern type. PO'TERNTYPE will contain a nunber and the 
file being used uill be TERM“nunber”.PUs. SYS. 
1 - The current tern type is specified by a file nane. 
PO’ TERATYPE will contain a 0. 
PP’ OELAYCR. (1:5) 
Indicates the anount of tine in 10ths of seconds to delay on CR. 
PP’ DELAYLF. (6:5) 
Indicates the anount of tine in 10ths of seconds to delay on LFs. 
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WORDS 20/29 


Contains the block node cursor string. 


WORD 35 

PP’ LAST’ SSBRK. (0:8) 

Contains the last subsysten break character detected. 

PP’ PARITY’ ENAB. (12:1) 

Indicates if parity checking should be enabled uhen the device is FOPEN’ ed. 


0 - Parity checking is disabled. 
1 - Parity checking is enabled. 


PP’ FOPEN’ PARITY. (13:3) 
Indicates what the parity should be when the device is FOPEN’ed. 
0 - Space. 
1 = Mark. 
2 - Even. 
3 - Odd. 
WORD 36 
PP’ 0D0’ ENRS. (4:1) 
Indicates if parity checking should be enabled if odd parity is sensed. 


0 - Parity checking is disabled. 
1 - Parity checking is enabled. 


PP* ODD’ PRRITY. (5:3) 
Indicates what the parity should be if odd (0) parity is sensed. 
0 - Space. 
1 > fark. 
2 - Even. 
3 = Odd. 
PP’ EVEN’ ENRB. (12:1) 
Indicates if parity checking should be enabled if even parity is sensed. 


0 - Parity checking is disabled. 
1 - Parity checking is enabled. 
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PP’ DELAYFF. (11:5) 


Indicates the anount of tine in 10ths of seconds to delay on FFs. 


WORD 16 
PP’ ENQBLOK. (0:8) 


Indicates the nunber of characters to send before doing the ENQ/ACK 
handshake. 


PP’ ENQCHAR. (8:8) 


Contains the inquire character, normally the ENQ. 


WORD 17 
PP’ NORCKACTION. (5:3) 
Indicates what to do if the ACK is not received on an ENQ/ACK handshake. 


1 - Resune urite with no ENQ. 
2 - Resune write with ENQ. 


PP’ ACKCHAR. (8:8) 


Contains the acknowledge character, normally the ACK. 


WORD 18 

PP’ BLOCK’ TRIG. (0:8) 

Contains the blocknode read trigger character, normally a OCI. 
PP’ TRIGGER’ CHAR. (8:8) 


Contains the read trigger character, normally a OC1. 


WORD 19 
PP’ BSRESP. (13:3) 
Indicates the response for the back space character. 


1 - Nothing. 

2 - Send end of nediun. 
3 - Send a "LF". 

4 - Send a "/". 

§ - Erase the character. 
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PP’ EVEN’ PARITY. (13:3) 
Indicates what the parity should be if even (1) parity is sensed. 


0 - Space. 
1 - Mark. 
2 - Even. 
3 - Odd. 


WORD 37 
PP’ XON’ TINE. (8:8) 


Contains the ancunt of tine in seconds to wait for the XON after an XOFF. 


WORDS 42/73 


Contains a special character function code for each of the 128 ASCII charac- 
ters. This is an array of 128 4-bit entries. There is one entry for each 
character, going sequentially fron 0 to 127. The special character functicn 
codes are as follous: 


0 - No special functicn. 

1 - Console attenticn (i.e., Control-A). 

2 - Cancel one character (i.e., backspace). 

- Horizontal tab. 

- Linefeed. 

- Type 1 end-of-record (i.e., CR). 

- iype 2 end-of-record (i.e., an I10Q EOR character). 


Block node alert character (i.e., 0€2). 
x 

10- Reurite input buffer. 

11- Cancel line (i.e., Control-X. 

12- Subeyeten break (i.e., Control-¥). 

13- Strip and ignore. 

14- Escape character. 
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Narduare O11 Fornat 


ATP/ATP37 Harduare DIT Fornat 


30465 6 27 8 §Y 1 11 12 13 «14 «18 


| | 
O| SYSOB RELATIVE POINTER TO LOGICAL DEVICE MONITOR DIT | 


SSO 6 CS SOOOSSS 2 OS C4 BOS OC O44 68 6284S OOS OSES SE 82982 2E2EE8 2846808922808 7 a 


| | 
1| TERMINAL OST RELATIVE POINTER TO PROTOCOL & DATA DIT | 


| 
2| TERMINAL OST RELATIVE POINTER TO CONTROL PROGRAN AREA | 
| weoscce | oon] cee] coewccccceneese | covnwoncacacocececoesovose aewen 
ICONTROLIMOO|NON| WAIT | i 
TYPE ie sed per TRUE ines rie NUMBER 
JPRIJECOLIDLISPOISET] | | | | 
4|CHRIENA|URT|SPCIMAK| | LAST HW STATE | | HARDWARE STATE| 


S|SPP|PRF|  JEOZ/BROITTY| FFIXON|WIO|PRR GEN| CK| LINE SPEED | 


6| NEXT TO LAST INTERRUPT REASON | LAST INTERRUPT REASON | 
Leoni reggae 
tum oo ee \s 
ficmuea ee re ‘3 
waite anaes {10 
Siam ee 
Wan ee 
CMe loncome) RIT IN9 
16| FRenane EMaR COT i eecM Va 
rrlove| pce DATE CODE {P/F} REC DATE CODE |P/F| ASC OATE CODE |JPT|15 

| aol MEXT STATE | | PS| | RODEN OUTPUT CONTROL ‘6 
o1| RODEN INPUT REFERENCE 7 ‘oven Tut cowrton iT 
i PRIMARY SPECIAL CHARACTER MASK (8 WORDS) 8 

Cea, 
ATP/ATP37/ROCC 
ORO 3 
HW’ CONTROLLER(3). (0:2) 


Indicates the type of controller. 


0 - Unused. 
1 - ATP controller. 
2 - ROCC controller. 
3 - Unused. 


Hil MODEMPANEL(3). (2:1) 
Indicates the type of connecticn/ junction panel. 


© - Direct connection, device subtype uae configured as 0 or 14. 
1 = flcden connection, device subtype was configured as 1 or 15. 


HU’ NONSS(3). (3:1) 
Indicates the type of CPU. 


0 - Series 64 type CPU. 
1 - Series 40/44 type CPU. 


HW’ WAIT’ REASGN(3). (4:4) 


This indicates hou the next interrupt should be processed. A wait reason is 
set up when the driver 18 about to halt the PCC and will want to selectively 
process the next interrupt. Wait reasons are as follous: 


0 - No wait reason. Process the interrupt as per the interrupt 
type. 

1 - Abort pending. The physical driver is trying to halt the 
PCC. feden interrupts are processed otheruise all other 
interrupts satisfy the halt. 

2 - Reset DIT. The port ie being reset. When the next 
interrupt eccurs the reset will be conpleted. 

3 - Disconnect. The PCC is being halted so that a control 
progran can be started to disconnect the noden. Any 
interrupt will satisfy the halt. 

4 - MCC setup. The NCC is being set up and the driver is 

waiting for the “end of control progran” interrupt 

indicating the ACC has been set up. Any interrupt except 
noden errors will satisfy the setup conplete. 

Monitor noden signals. The driver has set up the ACC and 

is waiting for an interrupt indicating that a noden line 

is in the correct state, 1.e., DSR on. 

£02 reset. The PCC is hung and the driver is in the 

process of resetting the PCC before it dces the next read or 

write. 


an 
a 
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ATP/ATP37 Hardware DIT Fornat (Cont. 


SOee CCS 28 2ABeee | C8 SSeS OGeOeGO | fe 224 BAB see4s taeam 


2 (26 
35| SECONDARY SPECIAL CHARACTER SET (4 WORDS) < 
36 |30 
41| URITE SPECIAL CHARACTER SET (4 WORDS) ig 
42 13 
45| WRITE EDIT SPECIAL CHARACTER SEY (4 WORDS) Aa 
46| WRITE BUFFER is 

| ees cecewe we wen swwecncec cee cnnensecws cece econcoreovnsocooccosce 
47 139 
a cae a (8 WORDS) ne 
aul be | DIRGNOSTIC INTERRUPT CODE - 

[one |non=|---nccnneennnanennenenn|oseneenenecennrnnenennnnennennn 

| 148 
61| SAVED CLOCK sy - (2 WORDS) ; be 
62] BLOCK COUNT CR DELAY ENQ CHARACTER LF SELAY }50 
63| ACK CHARACTER |! FF DELAY |S1 


WORD 0 
HU’ LOITP 


SYSOB relative pointer to the logical monitor DIT. 


WORD 1 
HU’ POITP 


Terninal OST relative pointer to the protocol and data nanagenent DIT. 


WORD 2 
Hu’CP’P 


Terninal OST relative pointer to the control progran area. Control progran 


area is 32 bytes. 
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7 - Dunp port. The PCC is dumping its RAN. 

8 - Speed-specified. The hardware is uaiting for the “end 
of control progran” interrupt indicating that the harduare 
has been set up accordingly as 2 speed-specified port. 


HU’ UNIT’ NUM(3). (8:8) 


Indicates the true unit nunber of the device. Unit nunbders will range fron 0 


to 127. 


WORD 4 
Hi’ PRISPCL(4). (0:1) 
Indicates what read special character set 18 being used. 


0 - Secondary read special character set enabled. 
1 - Prinary read special character set enabled. 


HU’ ECHO(4). (1:1) 
Indicates the current etate of echo. 


0 - Echo is disabled. 
1 - Echo is enabled. 


HU’ TOLE’WRT(4). (2:1) 


Indicates if the current perforn I/0 will write cut one or tuo trigger 


characters before the read begins. 


0 - Mo trigger characters are to be sert. 
1 - One or tuo trigger characters are tc be written. 


Ku’ SPDS(4). (3:1) 
Indicates uhether the port is a speed-specified port. 


0 - The port 18 speedsens: ng. 
1 - The port is speed-specafied. 


HU’ MCC’ SETUP’ UAK(4). (4:1) 
Indicates whether we wait for eno CP after setting up moden signals. 


0 - Wart for end CP. 
1 - Bo not wait for end CP. 
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HW’ LSTSTATE(4). (6:4) 


This indicates the last state of the PCC. When an interrupt occurs the cur- 
rent state in HW’STATE is saved in HW’OLD’STATE. Then HW’STATE is set to 
"input save". 


HW’ STATE(4). (12:4) 


This indicates the current state of the PCC. Set uhen a PCC control progran 
is started or after an interrupt occurs. Possible states are as follous: 


- Reading. 

- Writing. 

- Speedsensing. 

- Unused. 

- Set port protocol. 

- Set special characters. 

- Selftest. 

- Dunpang PCC. 

- Port is frozen. 

10 - Reading noden inputs. 

11 - Reset. 

12 - Idle read. 

13 - Setting up noden signals. 
14 - Monatoring noden signals. 
15 - Input save. 
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WORD 5 
Hil’ SET’ PROTCCOL(5). (0:1) 
Indicates if the PCC has done a set port protocol. 
© - The PCC has not done a set port protocol. No 1/0 
should be done until after a set port protocol. 
1 - The PCC has done a set port protocol. The current 
protocol 18 indicated in bits 11/15 of this word. 
HW’ POWERFAIL(S). (1:1) 
Indicates if a pouer fail hes occurred and is being processed. 


0 - No pouer fail hae occurred. 
1 - Power fail has cccurred. 


HW’ RESET’ OIT(5). (2:1) 
Indicates if the harduare DIT is being reset. 


QO - DIT is not being reset. 
1 - DIT is being reset. 
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HU’ XON’ ENRB(S). (7:1) 
Indicates if the PCC will do the XON/XOFF handshake. 


0 - The PCC will not do the XON/XOFF handshake. 
1 - The PCC will do the XON/XOFF handshake. 


HU’S* BIT’ RCDE(S).(8:1) 
Indicates the size of the data character. 


© - Data will be transmitted as 7-bit with a parity bit. 
1 - Data will be transnitted as 8-bit data. 


Hu’ PRRITY’ GEN(5). (9:2) 


Indicates the type of parity generation. This field is only valid for 7-bit 
data. 


© - Output disabled and the 8th bit is forced to 0. 
1 - Gutput disabled and the 8th bit is forced to 1. 
2 - Output parity generation is enabled and it will be even. 
3 - Output parity generation is enabled and it will be odd. 
HU’ PARITY’ CHECK(S). (11:1) 
Indicates if input parity checking is enabled. 


© - Input parity checking is disabled. 
1 - Input parity checking is enabled. 


HW” LINE’ SPEED(S). (12:4) 


Indicates the current transfer rate of the PCC. 


Q- 110 beud. 
1- XO baud. 
2- 600 baud. 
3 od 1200 baud. 
4- 2400 baud 
§ - 480 baud 
6 = 19200 baud 


7 = 9600 baud. 
8 - 76800 baud - unsupported. 
§ - 9600 baud. 
10 - 1200 baud. 
11 - WO baud. 
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Mu’ CLEAR’ E02(5). (3:1) 


Indicates if the driver is in the process of resetting the PCC to clear up 
the problen of the PCC getting hung because locaticn EO of its RAN never is 
cleared. 


© - The driver is not trying to fix a hung PCC. 
1 - The driver is in the middle of trying to free a hung PCC. 


Hu’ BROKEN(S). (4:1) 
Indacates if the port is broken. 


© - The port 18 not broken. 
1 - The port 18 broken and will not cperate until reset. 


Hu’ DELAY’ ENAB(S). (5:1) 
Indicates if TTY delays are enabled. 


0 - TTY delays are disabled. 
1 - TTY delays are enabled. There will be a delay 
following the transmission of each "CR", "LF", or "FF". 


Hu’ FF’ ENAB(S). (6:1) 
Indicates if forn feeds are enabled. 


© - Forn feeds are disabled. Each forn feed character will 
be replaced with a "LF". 

1 - Forn feeds are enabled. Esch "FF" character is uritten 
cut and not replaced with a “LF”. 
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WORD 6 
HU’ LAST’ INTERRUPT(6). (0:8) 


Contains the old interrupt code. When an interrupt occurs the interrupt code 
in HU’INTERRUPT’CODE is moved here and the new interrupt is placed in 
HU’ INTERRUPT’ CODE. 


HU’ INTERRUPT’ CODE (6). (8:8) 


Contains the last interrupt code. Sone of the interrupt codes have different 
meanings depending on the PCC version. Those different codes are noted. 
Interrupt codes 20/28 are only for pass 3 PCCs. 


0 - Invalid. 

1 - Redundant start 1/0. 

2 - End control progran. 

3 - Illegal control progran. 

4 - Urite special character. 

5 - Ten-second ACK tinecut. 

6 - Read conplete. 

7 - Parity error. 

8 - Read special character. 

9 - Pass 2 PCCs - break detected. Pass 3 PCCs - franing error. 
10 = Overrun error. 

11 - Pase 2 PCCs - character read and not in read state. 

pase 3 PCCs - not used. 

12 - Speedsense conplete. 

13 - Pass 2 PCCe - noden error. Pass 3 PCC - break detected. 
14 - Write conplete. 

15 - Selftest conplete. 

16 - Edit special character. 

17 - Diagnostic failure. 

18 - Control progran halted. 

19 - Dunp conplete. 

20 - Moden data overrun. 

21 - Roden AIG hardware errer. 

22 - noden invalid PCC reed. 

23 - Moden PCC nessage error. 
24 - floden link error. 

25 ~ floden debounce error. 

26 - Noden non-naskable interrupt error. 

27 - NC6801 error. 

28 - Unknown noden error. 


WORD 7 
HU’ READ’ CNT 


Current PCC read byte count. 
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WORD 8 


Note that this word is used in full for the ATP DNA registers. It should not 
be changed in its fornat. 


Hu’ RO’ RIGHT’ LEFT(8). (1:1) 
Indicates to the PCC what byte to start the transfer to. 


© - Left. 
1 =. Right. 
HU’ RERD’ BANK 


Indicates the bank nunber for the current read. 


WORD 9 
Hu’ READ’ ADOR 


Contains the absolute start address of the read. 


WORDS 8/9 
Hi? READ’ RBS’ ADOR 


Contains a double word absolute start address for the read. 


WORD 10 


Note that this word is used in full for the ATP ONA registers. It should not 
be changed in its fornat. 


HU’ UT’ RIGHT’ LEFT(10). (1:1) 
Indicates to the PCC uhat byte to start the urite fron. 


0 bas Left. 
1- Right. 


HW’ URITE* BANK 
Indicates the bank nunber for the current urite. 


WORD 11 
HU’ URITE’ ADDR 


Contains the absolute etart address of the write. 
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Hu’ SELFTEST 
Contains the results fron the PCC/NSC selftest. 
Wl’ PCC’ PF(15). (0:1) 


Indicates the results of the PCC selftest. 


© - Selftest passed. 
1 - Selftest failed. 


Hl’ PCC’ DATE(15). (1:4) 
Contains the current PCC date code. 
0 - Passe 1 PCC. 
1 - Paes 2 PCC. 
2 - Paes 3 PCC. 
3 - Pass 4 PCC. 
HU’ FICC’ PF (18). (5:1) 
Indicates the results of the (ICC selftest. 


0 - Selftest passed. 
1 - Selftest failed. 


HW’ ACC’ OATE(15). (6:4) 
Contains the current ICC date code. 
0 - Pass 1 ACC. 
1 = Pass 2 NCC. 
2 = Pass 3 ACC. 
Wal’ ASC’ PF (15). (10:1) 
Indicates the results of the MSC selftest. 


0 - Selftest passed. 
1 - Selftest failed. 


Wu MSC’ORTE(15). (11:4) 


Contains the current MISC date code. 


0 - Pass 1 MSC. 
1 - Pass 2 MSC. 
2 - Pass 3 ASC. 
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WORDS 10/11 
HW’ WRITE’ ABS’ ADOR 


Contains a double word absolute start address of the urite. 


WORD 12 
HW’ WRITE’ CNT 


Current PCC urite byte count. 


WORD 13 
HU* OLD’ OIRECT’CND(13). (0:4) 


Contains the old direct connand. When a new direct connand is issued 
HU’DIRECT’CONMNAND is saved here. Then the new direct connand is saved in 
HW’DIRECT’CONMAND. Possible direct connands are: 


1 - Moden freeze. 

2 - PCC freeze. 

4 - Start 1/0. 

8 - Halt direct connand. 


HW’ DIRECT’ COMMAND(13). (6:4) 


Contains the last direct connand issued. When 3 new connand is issued the 
old connand is saved in HW’ OLD’DIRECT’CHD. 


HW’ OLD’ WAIT REASON(13). (13:3) 


Contains the old wait reason. HU’UAIT’ REASON is saved here before a new wait 
reason is set up. 


WORD 14 
Hu’ FRAMING’ ERROR(14). (0:8) 


Contains a running count on the nunber of franing errors that occur. Used 
only for gathering infornation uhen dunpe are read. 


HU’ SPEC’ CHAR(14). (8:8) 


Contains the last special character detected. Updated each tine a neu spe- 
cial character is detected. 
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Hu’ JUNCTION’ TYPE(15). (15:1) 


Indicates the type of junction panel. 


WORD 16 
Hu’ NEXT’ STATE (16). (0:4) 


Indicates the next state of the PCC. See Hi’PENDING’START for an explanation 
of how this field is used. 


HU’ PENDING’ START(16). (6:1) 


Indicates if there is a pending start. This occurs when the driver is active 
and a noden signal changes preventing the next read or write fron starting. 
Everything is saved in the DIT and uhen the noden line is correct (i.e., D 
is on) the read or write will be started. 


0 - No pending start. 
1 - A pending read or urite is ready. 


Hu" MODERN’ OUTPUT (16). (8:8) 


Contains an 8-bit noden output control nask. If a bit is set then that sig- 
nal wall be “on” or plus 12 volts. 


Bit 0 - Frequency select. 

Bit 1 - High order binary digit. 
Bit 2 - Second order binary digit. 
Bit 3 - Low order binary digit. 
Bat 4 - Secondary request to send. 
Bit § - Call request. 

Bit 6 - Request to sent. 

Bit 7? - Data terninal ready. 


WORD 17 
Hu MODEM’ REF (17). (0:8) 


Contains an 8-bit noden reference nask. There is one bit for each input sig- 
nal. If the signal is different fron the reference and is a needed signal as 
specafied by the control nask then an interrupt will occur. 


Bit 0 - Unused. 

Bit 1 - Clear to send. 

Bit 2 - Signal quality. 

Bit 3 - Data set ready. 

Bit 4 - Call origan status. 

Bit S - Secondary carrier detect. 
Bit 6 - Ring indicator. 

Bit 7? - Carrier detect. 
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Hu’ MODEN’CTL(17). (8:8) 

Contains an 8-bit noden contro] nask. There is one bit for each input sig- 
nal. If the bit is set then the signal will be used, otherwise it is 19- 
nored. The nask is the sane as in HW'NODEN’REF. 

WORDS 18/25 

Hu’ PRI’ SCHRS 

Contains an 128-bit mask of the prinary special character set. There is 
1-bit for each of the 128 ASCII characters. If set then the character is a 
special character. The bit map has to be locked at as a 16-byte nap where 
the characters are nunbered 0-7, right to left. For exanple if Control-A is 
a special character the first word of the table would be 21000. If backspace 
was set the first word would be 1. 

WORDS 26/23 

Hu’ SEC’ SCHRS 


Contains an 8-character buffer for a secondary special character set. 


WORDS 30/33 
HW’ URI’ SCHRS 


Contains an 8-character buffer for write special characters. 


WORDS 34/37 
HU’ EDIT’ SCHRS 


Contains an 8-character buffer for urite edit special character set. 


WORD 38 
KU WRITE’ BUFR 


Contains a 2-character write buffer used to send trigger characters for 
reads. 


WORDS 39/46 
HW’ READ’ BUFFER 


Contains a 16-character read buffer used by the PCC for idle reads. 
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WORD 47 
HW’ DIAGNOSTIC(47). (0:1) 
Indicates if the diagnostics are running. 
0 - The diagnostics are not running. . . 
1 - The diagnostics are running and all interrupts will be 
processed by the diagnostics. 
Hu’ DIAG’ INTERRUPT(47). (1:1) 


Indicates if an interrupt occurred that has to be processed by the 
diagnostics. 


0 - No interrupt has occurred. 
1 - An interrupt has occurred and the interrupt reason is 
in HW’ DIAG’ REASON. 

HW’ DIAG’ REASON(47). (8:8) 
Contains the current diagnostic interrupt code. The current interrupt code 
is saved here when an interrupt occurs and the diagnostic bit is set. The 
interrupt codes are the sane as specified in Hu’ INTERRUPT’ CODE. 
WORD 48/43 
HW’ MODERN’ TINE 
Contains the current clock value uhen a noden control progran is started. 
Uhen the driver is to halt the PCC and this word is non-zero then the halt 
will not occur until 200 nsec have passed. This is to prevent a noden over- 
run error. 
UGRD 50 
Hu’ PP1(50). (0:8) 
Contains either the ENQ/ACK block count or the CR delay. 
Hu’ PP1 (50). (8:8) 
Contains either the ENQ character or the LF delay, depending on uhether we 
use ENQ/ACK handshake or tine delay for flow control. 
WORD 51 
Hu’ PP2(51). (0:8) 
Contains either the ACK character or the FF delay. 
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WORD 0 
Hu’ LOITP 


SYSOB relative pointer to the logical monitor DIT. 


WORD 1 
KW’ POITP 


Terninal DST relative pointer to the protecol and data nanagenent OIT. 


WORD 2 
Hu’CP’P 


SYSDB relative pointer to the channel progran area. 


WORD 3 
HW’ CONTROLLER(3). (0:2) 
Indicates the type of controller. 
0 - Unused. 
1 - ATP controller. 
2 - ADCC controller. 
3 - Unused. 
HW MODENPANEL(3). (2:1) 
Indicates the type of connecticn/ junction panel. 


© - Direct connection, device subtype was configured as 0 or 14. 
1 = Modem connecticn, device subtype was configured as 1 or 15. 


Ku’ NONS5(3). (3:1) 
Indicates the type of CPU. 


0 = Series 64 type CPU. 
1 = Series 40/44 type CPU. 


HU’ORT(3). (7:9) 


Contains the 9-bit ORT nunber of the device. This consists of a 2-bit INS 
hunber, 4-bit channel nunber, and 3-bit device nunber. 
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WORD § 
Hu’ SET’ PROTOCOL(S). (0:1) 
Indicates if the ADCC has done a set port protccol. 
0 - A set port protocol has not been done. 
1 - A set port protocol has been done. The current 
protocol is indicated in bits 11/15 of this word. 
Hu’ PONERFATL(S). (1:1) 
Indicates if a pouer fail has occurred and is being processed. 


0 - No power fail has occurred. 
1 - Power fail has occurred. 


Hu’ BREAK’ DETECTEO(S). (2:1) 
Indicates that a BREAK condition has been detected. 


0 - No BRERK condition detected. 
1 = A BREAK condation 28 currently being processed. 


HU’ BROKEN(S). (4:1) 
Indicates if the port is broken. 


0 - The port is not broken. 
1 - The port is broken and will not operate until reset. 


Hu’ OELAY’ ENAB(S). (5:1) 
Indicates if ITY delays are enabled. 
0 - TTY deiays are disabled. 
1 - TTY delays are enabled. There will be a delay 
following the transnissicn of each "CR", "LF", or "FF". 
HW’ FF’ ENAB(S). (6:1) 
Indicates if forn feeds are enabled. 
0 - Form feeds are disabled. Each form feed character will 
be reclaced witn a "LF". 
1 = Form feeds are enatled. Each "FF" character is written 
out and not replaced with a "LF". 
Hu’ XON’ ENAB(S). (7:1) 
Indicates if the driver will do the XON/XOFF handshake. 


0 - The driver will not do the XON/XOFF handshake. 
1 - The driver will do the XON/XOFF handshake. 
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WORD 4 
HU" PRISPCL(4). (0:1) 
Indicates what read special character set is being used. 


0 - Secondary read special character set enabled. 
1 - Prinary read special character set enabled. 


HW°DO’ KON’ XOFF(4). (1:1) 

This bit indicates if XON/XOFF handshaking is enabled. 

HU’ SETUP’ WAKE (4). (2:1) 

Indicates whether ue wait for end CP after setting up noden signals. 


0 - Wait for end CP. 
1 - Do not wait for end CP. 


HW’ OLD’ STATE(4). (6:4) 


This indicates the last state of the ADCC. When an interrupt cecurs the cur- 
rent state in HU'STATE is saved in HW’OLD’STATE, if the state is not "input 
save". Then HU'STATE 18 set to "input save". 


Hu’ STATE(4). (12:4) 


This indicates the current state of the ADCC. Set uhen an RDCC channel 
progran is started or after an interrupt occurs. Possible states are as 
follous: 


- Reading. 

- Writing. 

- Speedsensing. 

- Generating an interrupt fron an input save event. 
- Set port protecol. 

- Set special characters. 

- Unused. 

- Unused. 

- Unused. 

10 - Unused. 

11 - Outputting trigger characters. 
12 - Idle read. 

13 - Setting up ncden signals. 

14 - Ronitoring noden signals. 

15 - Input save. 
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Hu’ 8° BIT’ NODE(S). (8:1) 
Indicates the size of the data character. 


O - Data will be transnitted as 7-bit with a parity bit. 
1 - Data will be transnitted ss 8-bit data. 


HW PARITY’ GEN(S). (9:2) 


ee the type of parity generation. This field is only valid for 7-bit 
ta. 


© - Output parity generation is enabled and it will be even. 
1 = Output parity generation is enabled and it will be odd. 
2 = Output paraty generation is enabled and it will be even. 
3 - Cutput parity generation is enabled and at will be odd. 
Hu’ PARITY’ CHECK(5)..(11:1) 
Indicates if input parity checking is enabled. 


© - Input parity checking is disabled. 
1 - Input parity checking is enabled. 


Hu’ LINE’ SPEED(5S). (12:4) 


Indicates the current transfer rate of the ADCC. 


0 - €External - unused. 
1- External - unused. 
2- SO baud - unused. 
3- 75 baud - unused. 
4- 13.5 baud - unused. 
§ - 200 baud - unused. 
6 - 60 baud. 
7 = 2400 baud. 
8 - $600 baud. 
9 - 4800 baud. 
10 - 1800 baud - unused. 
41 =- 1200 baud. 
12 = 2400 baud. 
13 - 30 baud. 
14- 18 baud. 


18 = 110 baud. 
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WORD 6 
HU OLD’ INTERRUPT(6). (0:8) 


Contains the old interrupt code. When an interrupt occurs the interrupt code 
in HW’ INTERRUPT’CODE as moved here and the new interrupt is placed in 
HW’ INTERRUPT’CODE. The first two bats show the CPVA nunber and the renaining 
bits are the interrupt code. 


Hu’ INTERRUPT’ CODE(6). (8:8) 


Contains the last interrupt code. The first tuo bits are the CPVA nunber, 
and the last six bits are the interrupt code. 


CPVR 0 - Belated HICP interrupt and channel progran aborts. 
CPVA 1 - Speedsensing interrupts and ACK wait interrupts. 


Q - Unused. 

1 - 9600 baud or first part of 4800 baud. 

2 - First part of 2400 baud. 

3 - First part of 1200 baud. 

4 - First part of 600, 300, or 110 baud. 

5 - Second part of 600 or 300 baud. 

6 - Second part of 110 baud. 

7? - Last part of all but 9600 baud. 

8 - Non-speedsense detected by channel progran. 
9 - Moden lines nay have changed. 
10 - Special character received during ACK wast. 


CPVA 2 - Input Save state interrupts/Error conditions 


0 - Unused. 

1 - Input save buffer full. 

2 - Error condition during input save. 

3 - Special character during input save. 

4 - Error condition (overrun, parity, franaing, 
break, neden change). 


CPVA 3 - Standard channel progran interrupts. 


0 - Unused. 
1 = Unused. 
2 - End of set port protocol. 
3 - Unused. 
4 - Special character during write. 
5 - Unused. 
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HW’ READ’ BANK 


Indicates the bank nunder for the current read. 


WORD 9 
HW’ RERD’ RODR 


Contains the absolute start address of the read. 


WORD 10 
HW’ UT’ RIGHT’ LEFT(10). (1:1) 
Indicates what byte to start the urite fron. 


0 - Left. 
1 = Right. 


HU’ WRITE’ BARK 
Indicates the bank nunber for the current urite. 


WORD 11 
KW’ WRITE’ ROOR 


Contains the absolute start address of the urite. 


WORD 12 
HW’ URITE’ CNT 


Current write byte count. 


WORD 13 
Hu’ DELAY’ CHAR(13)(0:8) 


Contains the last character (either output data or a trigger character) that 
requires delay synce after it. 


Hu’ DELAY’ INT(13). (8:8) 


Contains the interrupt code to generate after the delay syncs have been 
generated. 
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6 - Read conplete. 

7 - Parity error detected. 

8 - Special character during read. 

9 - Franing error detected. 

10 - Overrun error detected. 

11 - Unused. 

12 - Unused. 

13 - Break detected. 

14 - Urite conplete. 

15 - Unused. 

16 - Edit special character found. 

17 - Unused. 

18 - Unused. 

19 - Unused. 

20 - Unused. 

21 - Unused. 

22 - Unused. 

23 - Unused. 

24 - Unused. 

25 - Unused. 

26 ~ Unused. 

27 - Unused. 

28 - Unused. 

29 - Modern line change detected. 

30 - Need to insert pad characters. 

31 - Special character during wait. 

32 - Trigger characters written. 

33 - An ENQ character has been written. 
34 - An ACK character has been uritten. 
35 - End of moden control channel progran. 


WORD 7 
Ku’ READ’ CNT 


Current read byte count. 


WORD 8 
HU’ RD’ RIGHT’ LEFT(8). (1:1) 


Indicates what byte to start the transfer on. 


0 - Left. 
1 - Right. 
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WORD 14 


HU’ FRAMING’ ERROR(14). (0:8) 


Contains 3 running count on the nunber of franing errors that occur. Used 
cnly for gathering infornation when dunps are read. 


Hi’ SPEC’ CKAR(14). (8:8) 


Contains the last special character detected. Updated each tine a neu spe- 
cial character is detected. 


WORD 15 
KU’ SENSE* TIMER 


When the first interrupt during a speedsense cccurs (the first part of the 
bit pattern has been received), a one-second tiner is started to abort the 
sense if not conpleted during that tine. This word is used to store the 
tiner request index. 


WORD 16 

HW’ NEXT’ STATE(16). (0:4) 

Indicates the next state of the ADCC. 
HU’ MASK’ OFF (16). (8:8) 


This word certains the Sit pattern necessary to mask off all noden signals. 
This is used whenever a meden change is detected in order to cancel the chan- 
nel service request until the next request to change the noden output 
signals. 


WORD 17 
KW’ MUDEN’ REF (17). (0:8) 


Contains an 8-bit r-den reference masx. There is one bit for each input sig- 
nal. If tre signal is different fran the reference and is a needed signal as 
specified by the control mask then an interrupt will cccur. 


Bit 0 - Unused. 

Bat 1 - Unusea. 

Bit 2-0 8 reference (1 = nask). 

Bit 3 - Clear te send. 

Bit 4 - Data set ready. 

B:t § - Ping indicator. 

Fit 6 - Dera carrier detect. 

“1t ? - Secondary data carrier detect. 
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Hu’ MODEM’ CTL(17). (8:8) 

Contains an 8-bit noden control mask. There is one bit for each input sig- 
nal. If the bat 18 set then signal will be used, otherwise it 18 ignored. 
The nask is the sane as in Hu’NODEN’REF. 

WORDS 18/25 

HW’ PRI’ SCHRS 

Contains an 128-bit mask of the prinary special character set. There is 
1-bit for each of the 128 ASCII characters. If set then the character is a 
special character. The bit map has to be looked at as a 16-byte nap uhere 
the characters are nunbered 0-7, left to right. For exanple if Control-A 18 
a special character the first word of the table would be 2100000. If 
backspace was set the first word would be 2200. 

WORDS 26/29 

Hil’ SEC’ SCHRS 


Contains an 8-character buffer for a secondary special character set. 


UORDS 30/33 
HW’ URI’ SCHRS 


Contains an 8-character buffer for urite epecial characters. 


WORDS 34/37 
HW EDIT’ SCKRS 


Contains an 8-character buffer for write edit special character set. 


WORD 38 

HU’ URITE’ BUFR 

cone a@ 2-character urite buffer used to send trigger characters for 
WORDS 39/46 

HU’ READ’ BUFFER 

Contains a 16-character read buffer used by the ADCC for idle reads. 
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Ku’ MODEM’ OUT2(S1). (12:4) 

This field contains the identical information as HU’NODEN’OUTI. When the en- 
tire byte (8:8) is output to the ADCC, the noden lines are set and echo is 
meee off. This is used when transferring to the input save state fron a 
read. 

WORD $2 

HW’ SAVE" READ(52). (0:8) 


This field contains the character read whenever an error status is detected. 
This is needed to distinguish a break fron an ordinary franing error. 


Hu’ STATUS’ FE(S2). (12:1) 


This contains the franing error status bit read fron the UART. It indicates 
either a franang error or break. 


His’ STATUS’ OE(52). (13:1) 
This contains the overrun error status bit read fron the UART. 
HW’ STATUS’ PE(S2). (14:1) 


This contains the parity error status bit read fron the URRT. 


WORD 53 

HW’ UART(S3). (0:8) 

This field contains all the UART control infornation including character 
width, paraty, and stop bit information. It aleo has the bit eet which 
causes a naster clear to be perforned on the URRT. 

HW" SAVE’ MODEN(S3). (8:8) 

This field contains the status of the noden lines being monitored. Only bits 
3 through 7? of the byte are used and they have the eane fornat as 
Hi MODEM’ REF above. 

WORD 54 

Wij” INSAVE’ 0E(54). (0:1) 


Thas bit is set true uhen an overrun error was detected during input save, 
and cieared uhen the condition has been serviced. 


Hu’ TNSAVE’PE(54). (1:1) 
Thais bit is used as above for the parity error condition. 
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WORD 47 


Not currently used. 


WORD 48 

HW’ SPEC’ SPEED(48) 

If the port is configured as subtype 4 or 5, this word contains the speed (in 
CPS) at which we will initially set up the UART. This 18 the sane as the 
configured speed. 

WORD 49 


This word is currently used for performance neasurenents. 


WORD 50 
HU’ ENABLE’ XMIT (50). (0:8) 


This field contains the bit pattern necessary to enable the transnitter buff- 
er not full channel service request. 


Hu’ OISABLE’ XMIT(5O). (8:8) 

This field contains the bit pattern necessary to disable the transmitter 
buffer not full channel service request. 

WORD 51 

Hu’ ECHO(S1). (3:1) 

This bit indicates the current state of echo during reads. 


0 ~ Echo is off. 
1 - Echo is on. 


HU’ RODEN’ OUTI (51). (4:4) 
This field contains the current setting of the noden cutput lines. hen the 
entire byte (0:8) is output to the ADCC, echo and noden lines are set. The 
bits are used as follows: 

Bit 4 - Request to send. 

Bit 5 - Data terminal ready. 


Bit 6 - Speed select. 
Bit 7 - Secondary request to send. 
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HW’ INSAVE’ FE(S4). (2:1) 

This bit is used as above for the franing error condition. 
Hu’ INSAVE’ BREAK(54). (3:1) 

This bit is used as above for the break condition. 

Hil’ INSAVE' MODEN(S4). (4:1) 

This bit is used ae above for a noden line change. 

Hu’ INSAVE’ NORCK(S4). (5:1) 

This bit ie used as above for an ACK tineout. 

HU’ KON’ WAIT (54). (14:1) 


This bit indicates that an XOFF was received and the driver is waiting for an 
X0N to continue. 


HW’ ACK’ WAIT(S4). (15:1) 

This bit indicates that an ENQ wae sent and the driver is uaiting for an ACK 
to continue. 

WORD 55 

Hu’ ENQ’ BLOCK(55). (0:8) 


This field contains the block count of characters used in the ENQ/ACK hand- 
shake. If the value is zero, the handshake is not used. 


HW’ ENQ’ COUNT(55). (3.8) 


If ENQ/ACK is enabled, this field contains the nunter of characters left to 
write before another ENQ should be generated. 


Hu’ CR’ DELAY(5S). (8:8) 

If ENQ/ACK is disabled, this field cuntains the nunter of .1 seconds to delay 
after CR characters. 

WORD 56 

HW’ ENQ’ CHAR(S6). (0:#) 


If ENQ/ACK is enabled, this field contsins the Enouiry cheracter. 
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Hu’ LF*DELAY(S6). (0:8) 


If ENQ/ACK is disabled, this field contains the nunber of .1 seconds to delay 
after LF characters. 


Hu’ ACK’ CHAR(56). (8:8) 

If ENQ/ACK is enabled, this field contains the Acknowledge character. 

Hu’ FF’ DELAY(56). (8:8) 

If EXO/ACK is disabled, this field contains the nunber of .1 seconds to delay 
after FF characters. 

WORD 57 

HW’ ENQ’ TINER(57) 

When an Enquiry character has been uritten to the terminal, a ten-second 
tiner 1s started. This word contains the tiner request index for that tiner. 
WORO 58/73 

Hu’ CHAR’ ARP 

These sixteen uords contain a bit map which reflects the 256-bit map special 
character array in the harduare. 

WORD 74/81 

HU’ INSRVE’ BUF 


These sixteen bytes are used as the input save buffer. 


WORD 82/97 
HU’ CHAR’ BUFFER 


These thirty words are used as buffer space whenever the special character 
array in harduare must be changed. 


Message Table Fornat 


The message table is not used but contains the following: 


“or, lf, bell,bell”,"LDEV #1 NOT READY “,"cf, LF" 


8 
ATP/ATP37/ADCC 
ATP/ATP37 P r Area Fornat fn 
7 | case 
426| LOT - %7 WORDS AND LDTX (OR ZEROS IF KONE) - 25 WORDS | 
ge te ow a 
453| 100 PCB (CF ZEROS IF MONE) - 225 WORDS | 
A ee ee era 
500! LOT PCB (OR ZEROS IF NONE) - 225 WORDS | 
aaa aaa aR | 
700| PCC NERORY (OR ZEROS IF NONE) - 2200 WORDS | 
nea | 
720| ATP/ATP37 REGISTERS (OR ZEROS IF NONE) - 220 WORDS | 
aaa 
1120] USERS STACK - Z200 WORDS | 
11211 Pen ae Peewee te renee Pweg eee onan toa | 
1144| ILT ~ 216 WORDS AND ILTK - 26 WORDS f 
a aaa I 
1150| VFC SIR’S - 24 WORD 
ust; wea aa eee nae. I 


1152] VFC INFORMATION BLOCK - X2 WORDS 


| IOQ AND TEUF INFORMATION BLOCK - Z3 WORDS 


10Q°S - 214 WORDS EACH AND TBUF’S/SBUF’S - 2105/%200 WORDS 


9808880 0 OS OS CO 8 6 6 6 F 88 OS BOSE OSS OFS OBO SOE 0 0882 29ES OSE BE ODO ODTBOCO 
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Port Error Area Fornat 


ATP/ATP37 Port Error Area Forna 


3 45 6 7 8 § 11 1% 12 13 14 15 


O| NUMBER OF CALLS TO LYWX’ERROR 
| 


14] 
105} PROTOCOL AND DATA MANAGER FIXED DIT - 21S WORDS 
ia aa eee | 
221| PORT PROTOCOL DIT - 2114 WORDS 
222! pee ne are ete ae earn Tae Wea Seine ee te 7 
264| PROTOCOL AND DATA MANAGER VARIABLE OIT - 233 WORDS | 
a | 
340| ATP/ATP37 KARDUARE DIT - 264 WORDS | 
wp f 
352| TBUF TABLE - x12 WORDS 
3). CSCO i 
372| ATP/ATP37 CONTROL PROGRAM - X20 WORDS 
7) —— i 
376] LPDT - x4 WORDS I 
UU pena ee wae eee eal 
406| DLT - 210 UORDS | 
oT ee, ee eee, 
412| ORT - 26 UORDS | 
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The VFC infornation block contains the follouing: 


Word 0.(0:1) - 0: No VFC entry or data dunped. 
1: AVEC entry uas dunped. 
.(8:4) - Nunber of initialization buffers dunped. 
.(12:4) - Nunber of data buffers dunped. 


Word 2 - TOS relative pointer to I0Q/TBUF information blcck. 
The I0Q/TBUF infornation block contains the following: 

Word 0 - Nunber of I0Qs dunped. 

Word % - TOS relative pointer first TBUF dunped. 


Word 2.(0:2) - 0: No TEUFs or SBUFs were dunped. 
1: TBUFe were dunped. 
2: SBUFs were dunped. 

. (2:14) - Number of TRUFs or SBUFs dunped. 
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ROCCE Port Error Area Fornat ADCE P: rror Rrea Fornat 

123 4 § 6 7 8 §$ 10 411 «+12 «13 14 «15 | wnnw wenn nnrree cen nn nen n nnn nenerenennnwnn nanan eenwccenennennnns | 
wan | oon [ooo | one fone |---| --2 |-2- |o-= |---| 22 |---| oe f n=] --- |---| 767} | 

0| NUMBER OF CALLS TO LYNX’ ERROR : 
| -ecewweennenn--nen nnn nnnneeennennne cn eceenwe nena nenenennnennnne | 1002| LOT - 27 WORDS RND LDTX (OR ZEROS IF NONE) - 25 WORDS | 
1] | | ee nnnnenennenecenenmeneenenesenencnscnneerccsecnsecsenenens 
4 - 1003] | 
43| TERMINAL DATA SEGHENT HEADER - 243 WORDS | - - 
| pon nwnn ween nnn nono ccwen nen owennnccenenenscenewonecenwccncwnone | 1027| I0Q PCB (OF ZEROS IF NONE) - 225 WORDS | 
44 | | | eoee nen new en nnn new cewcnecwe wwe nweenneensonwwewosencnescocscocos | 
2 : 1030| | 
70| MONITOR DIT - 225 WORDS l - i 
Spe een ete ee ey | 1054| LOT PCB (OR ZEROS IF NONE) - 225 UORDS | 
Mp tteaeneerenanetenereenenasernsessenecncusonncnanaseressce 
6 1055] | 
105] PROTOCOL AND OATA MANAGER FIXED DIT - 215 WORDS | . x 
cncecwnwwenneee cnn cn enw enewncerecewenconecennecocs eocccccocen= | 1254] USERS STACK - 2200 WORDS | 
106] | font nenenenenenee nen ncnneenneeneneenenseesensnnennnconsosencoss | 
= 1255] | 

221| PORT PROTOCOL OIT - 2114 WORDS | i 

| poncnnnew nnn n nnn cow nn wn eter ecww sow enenewensewwncewwnwnnnsocere | 1300] ILT - 216 WORDS RAND ILTX - Z6 WORDS 

222] | | erence owen mewn nen nn nn ewww en wenn en nce nn ncn nee cnw nce erneereeecence | 
4 - 1301] 
254| PROTOCOL AND DATA MANAGER VARIABLE DIT - 233 WORDS | . zs 
| -menwewnnn nonce cone nw enn concn enn nnennnwn Onewecceennnwersenon-oe 1304] VFC SIRS - 24 WORDS | 
255] | | pneecm erm new nnn nnn meno e nc eeen wn nnnn en ene n nn ne nnn nennecencn= --| 
: - 1305| | 
416] ADCC HARDURRE OI - %142 WORDS | . = 
me mnewncwccccccoswecencccocene= se eemenenceweweenecesnccesensese | 1306] VFC INFORMATION BLOCK - 22 WORDS | 
ul ! eer ares aac suaomeray | 
430| TBUF TABLE - 212 WORDS | = = 
soecoroce wren ccencccsennnnnenwecoccocweccsocccnceccccoccesonnee| | VFC ENTRY (OR NOTHING IF NONE) - %20 WORDS | 
aan | peers ener rene ee sea 
746| CHANNEL PROGRAN - 2316 WORDS | id a 
com ewweweweweec cone sn cnn cwewcccncororarersowenwenenennecncowe ~-| | VFC BUFFER (OR NOTHING IF NONE) - Z105 WORDS | 
7471 ! acca a | 
752] LOT - x4 WORDS | . “ 
| conn ccc wn cere nn sen enn en ennnnenn nn eneceenoec cece cneeencecconecs | | 100 AND TBUF INFORMATION BLOCK - 23 WORDS | 
753] l (pee re ge eros | 
762| DLT - 210 UCRDS | 5 ns 
Scat ores g ee ge ey, ear Te | I0Q’S - 214 WORDS EACH RND TBUF’S/SBUF'S - 2105/2200 WORDS = | 











7631 tk # ilsssesssenceeneerssssssorrsace eee wmeme nec nen ew cece enewereseeces 
re ORT - 24 words 
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The VFC infornaticn block contains the following: WORD 0 
Word 0.(0:1) - 0: No VEC entry or data dunped. TBUF’ NUR’ URD 
: AVEC entry was dunped. 
-(8:4) - Nunber of initialization buffers dunped. Contains the nunber of TBUFs in the data segnent. 
- (12:4) - Nunber of data buffers dunped. 
Word 2 - TOS relative pointer to ICQ/TBUF infornaticn block. WORD 1 
The I0G/T8UF infornation bleck contains the following: TBUF ° READ’ SAVE(1). (0:8) 
Word 0 ~ Nunber of I0Qs dunped. Contains the nunver of TBUFs saved for reads. 
Word 1 - TOS relative pointer firet TBUF dunped. TBUF* BUFSIZE(1). (8:8) 
Word 2.(0:2) - : No TEUFs or SBUFs were cunped. Indicates the size in words of each TBUF. 
: TEUFs were dunped. 
2: S8UFs were dunped. 
(2:14) - Nunber of TBUFs or SBUFs dunped. WORD 2 
TBUF* LISTHERD’P 
TRUF_Table Fornat 
Contains a TOS relative pointer to the head TUF in the TBUF 
free list. 
7 8 9 1 1 12 «13 «14 «15 
Tee Posed Patel fete ered eed ted bee Led eed eee Gel Dd boo Dd 
O| NUMBER OF TBUF’S IN TOS | WORD 3 
1] TBUF’S SAVED FOR REROS | SIZE OF TEUF IN WORDS | TBUF’ LISTTAIL’ P 
1 TOS RELATIVE POINTER TO HEAD OF FREE TBUF LIST ral Up a TOS relative pointer to the tail TEUF in the TBUF 
eeccercnce enn cen nen ewecwen econ eeewenneceroccsoeoencceeseennne ree list. 
= TOS RELATIVE POINTER TO TAIL OF FREE T6UF LIST 
4| MAXIMUM NUMBER CF TBUF’S EVER IN USE WORD 4 
‘| CURRENT NUMBER OF TBUF*S IN USE TBUF * RRXUSED 
6| | Indicates the naxinun nunber of TEUFS in use at eny tine. 
i TOTAL NUMBER OF TEUF REQUESTS 
10] NUMBER OF TBUF REQUESTS DENIED WORD § 
11] UNUSED ! TALE INUSE’ URD 
| ccccecnennenewnennnneennnennnsnownnnnnoonce Ci Setusionasisacsdue 
Indicates the nunber of TBUFs currently in use. 
WORDS 6/7 
TOTALPE QUESTS 
Indicates “he total nunber of TBUF requeste. 
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WORD 8 

TBUF * DENTED’ URD 

Indicates the nunber of TEUF requests that were denied because 
there uere no free TSUF 

WORD 9 


Not currently used. 
TOUF Fornat 


| O08 SSS OF BOCES 8 65 SOS OOS 96688 0885080888 S82 2S SOS OSSSOSBOSO ODA ND eve 


O} TOS TABLE RELATIVE POINTER TO NEXT TBUF - O IF NO LINK | 


11 | 


103| USER DATA 
104] 0 - NEVER USED ! 
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WORD O 


DL’ TERN(O). (0:1) 
Indicates if the device is a terminal. Aluays a one. 


0 - Device is not a terminal. 
1 - Device is a terninal. 


DL'UP(O).(1:1) 
Indicates if the device is “up”. 


0 - Device is not up. 
1 - Device is up and has been speedsensed or FOPEN’ ed. 


OL’ ACTIVE(0). (2:1) 
Indicates the nonitor is active. 


© - The monitor is not active. 1 - The monitor is active and processing 2 
function. 


DL'REQUEST(0). (3:1) 
Indicates if the nonitor was awakened while active. 
0 - There is no pending request. 
1 - The nenitor was awakened while active and has a pending 
request. 
DL’ RESET(0). (4:1) 
Indicates if the nenitor should reinitialize the port. 
0 - Don’t reinitialize the port. 
1 - Reinitialize the port. This is equivalent to doing 
an ABORTION or device close against the port. 
OL’ PROKEN(0). (5:1) 
Indicates if the port is broken. 
Q - The port is not oroken. : 
1 - The driver detected an error and marked the port 
broken. The error code will be in DL’ ERROR' CODE. 
DL’ T2UFRVAIL(O). (7:1) 
Indicates 1f a TBUF is ncu available for the device. 
0 - No neaning. 
1 - A TBUF(s) is available and the urite can resune. 
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Terminal Monitor OIT Fornat 


123 4 § 6 7 8 § 16 11 12 13 14 1§ 
jte j ACT) JRE (BRO  {TBUl TRUE HRROUARE UNIT NURBER | 
O|RM UP |IVEJREQISETIKEN|  JFAVI OF PORT (0 - 127) | 


1{ Se 08 RELATIVE POLWTER TO NEXT DIT UATTING FOR SVSIO 
a| Toa TABLE RELATIVE POINTER TO MERD 100 
3| wort vevice wRBER | 
4| SvS DB RELATIVE POINTER TO ORIVER LINKAGE TRGLE | 
s Sen aLIVePwTen To BERT Gindse LE | 
iS) A tot HY tt | 
o| TyteReuPT MANAGER CORRUNICATION WORD 


Jone | eee [one |---| one nn no eeen | ene |oeeonen lone lor Jone | enone nn ee nee | 
JOJPREJPRE|BINISPD| WAIT [FLU] LOGON (NO |CON|PF | PREEMPT | 
JENPISPAIARYISNS| REASON [SH | TYPE |CATIMODIREC] LEVEL | 


14] DEVICE TYPE SUPPORTED | OUNNMY ORIVER JCONTROL| {NO {BRK} 





| BY THIS ORIVER | VERSION NUMBER [TYPE | SSIFIX{NOO| 
Cains 
Linnie | 
ta ee 
aol eT Mik wee 
oma | a 
no 
min 


08 6686 00 60 086 0880828088808 8 8O80O8S 00828 S9S8 BOSS OS SESS SAO OW OOO | 


24| LAST TIMED READ VALUE | 


00886800 98988090 C0080 0O8CO8 OSS 29S SOS8 22 SSS SSSOSSSSSSESOOOSCO | 
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OL’ TRUEUNIT (0). (8:8) 


Contains the true unit nunber of the device. Is cnly used for devices con- 
nected to an ATP/ATP37 controller. Unit nunbers will range fron 0 to 127. 


WORD 1 
DL’ REXT 


Contains a SYS OB relative pointer to the next DIT waiting for SYSIO/TERNIO. 


WORD 2 
OL’ 10aP 


Contains a OQ table relative pointer to the current 109. 


WORD 3 
OL’ LOEV 
Contains the configured logical device nunber of the device. 


WORD 4 
DL’ OLTP 


Contains a SYS 08 relative pointer to the driver linkage table. 


WORD § 
OL’ ILTP 


Contains a SYS 08 relative pointer to the interrupt linkage table. 


WORD 6 

DL’ TICK 

The TICK connunication uord. If a tiner is running and expires the bit cor- 
responding to the type of tiner is set in OL’TICK. The monitor is then 
auakened to process the tinecut. 

DL’ KANGUP’ T0(6). (0:1) 


Tiner used by the Initiatien Manager when disconnecting a noden. 
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DL CFAIL’ T0(6). (2:1) 


Tiner used by the Initiation Manager and Interrupt Manager when trying to 
connect a ncden, waiting for OSR and OCD to cone on or uhen there is a car- 
rier fail. 


DL’ XON’ T0(6). (4:1) 

Tiner used by the Interrupt Manager uhen waiting for an XON. 

DL’ READ’ T0(6). (8:1) 

Tiner used by the Initiation Manager and Interrupt Manager for reads. 
DL’ LOGON’ T0(6). (11:1) 

Tiner used by the nonitor for a logon tinecut. 

DL’ ACK’ T0(6). (14:1) 

Timer used by the RDOCC physical driver for a 10 ENQ/ACK timeout. 


WORD 7 
DL’ INT’ MAN 


The Interrupt fManager conmunication word. When the Interrupt Manager needs 
to awaken the monitor it will place an interrupt code in this word and then 
auaken the monitor via RUAKETERNINAL. This word contains 4 4-bit fields so 
that the Interrupt Manager nay awaken the monitor for nore that one reason. 
eee are processed by the monitor left to right. Interrupt codes are 
as follous: 


1 - Disconnect interrupt. Oata set ready has dropped or carrier 
fail hae occurred nore that 50 tanes during the read. The 
nonitor will initiate a disconnect sequence of the noden. 

2 - Partial harduare setup. The harduare has been partially 
set up and the nonitor will call the Initiaticn Manager to 
continue/finish setting up the harduare. 

3 - Partial read interrupt. The read has been conpleted or there 
were no TBUFs available to conplete the read. The monitor will 
call the Initiation Manager to conplete the read. 

4 - Partial urite interrupt. The urite wes a critical urite 
or there was an “RCK" tine out or tanking needs to be 
resuned on the write. The nonitor will call the 
Initiation Manager to continue/conplete the urite. 


5 - Speedsense interrupt. The device has successfully been 
speedsensed. The nonitor will awaken “DEVREC" for device 
recogniticn and then call the Initiation Manager to 
initialize the port. 
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DL’ WAIT’ RSN(8). (4:3) 


This indicates that the monitor is uaiting to be awakened by the Interrupt 
Manager. Wait reasons are as follous: 


0 - Not waiting. 
1 - Disconnect complete. 
2 - Harduare set up conplete. 
3 - Preenpt conplete. 
4 - Partial 100 conplete. 
§ - 100 conplete. 
6 - Hard reset conplete. 
7 = Unused. 
OL’ FLUSH(8). (7:1) 
Indicates if break was accepted by “BREAKIOB”. 


1 - Break was accepted and all 100s should be flushed 
until a clear flush and write request is processed. 


DL’ LOGON’ TYP(8). (8:2) 
Indicates the logon type. 
0 = Data accepting device. 
1 - Sessicn. 
2 - Job. 
DL’ DONT’ CAT(8). (10:1) 
DL’ CONSOLE(8). (11:1) 
Indicates if in console node. 


0 - Not in console node. 
1 - Device is in console node. 


OL’ PF*RECV(8). (12:1) 


Indicates if a power fail occurred and the driver should go through its pouer 
fail processing. 


0 - No power fail occurred. 
1 - A power fail has occurred and the driver will process 
the pouer fail. 
OL’ PRP’ LEVEL(8). (13:3) 


Contains the preenpt level of the current write. 
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6 - Subsysten break interrupt. fi subsysten break has been 
detected. The monitor will cali “BREAKSS” to see if APE 
will accept the subsysten break. The Initiation Manager 
is then called. If reading the read data 1s returned. 
If urating the write data 1s flushed. The flush bit is 
then set in all linked I0Qs. If the subsysten break as 
not accepted the current operation 1s resuned. 

7 - Operation done. The current write is complete and the 
monitor needed to be notified. 

8 - Break interrupt. Ai break interrupt has been detected. 
The monitor will call "8RERKJOR" to see if APE will 
accept the break. If accepted the Initiation Manager is 
called. If reading the read data is returned. If 
uriting all urate data is flushed. The I0Qs are then 
narked broken. If the break is not accepted the current 
operation is resuned. 

9 - Reset done. The reset of the port is complete. The 
monitor will either continue with the “open” if in the 
middle of the “open” or start of a speedsense. 





WORD 8 
DL’ PREENPT(8). (0:1) 
Indicates if there is a preenptive request. 
0 - No preenptive request. 
1 - Set by ATTACHIO if there is a preenptive I0Q linked 
in the DIT. 
DL’ PRESPACE(8). (1:1) 
Indicates if the driver is prespacing urites. 


0- hea poe is not enabled. 
1 - The last ICQ specified prespacing. 


DL’ BINARY(8). (2:1) 
Indicates if in binary node. 


0 - Not in binary nede. 
1 - Binary node. 


OL’ SPD° SNS(8). (3:1) 
Indicates if the device has been speedsensed. 


0 - The device hae not been speedsensed. 
1 - The device has been speedsensed. 
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WORD 9 
OL’ PD’ DITP 
Contains a TOS relative pointer to the Protocol and Data Manager DIT. 


WORD 10 

DL’ UNIT(10). (8:8) 

Contains the configured logical unit nunber of the device. It is only used 
for devices connected to the ATP/ATP37 centroller. Unit nunbers will range 
fron 0 to 35. 

WORD 11 

DL’ DATE’ CODE 

Contains infornation that indicates the level of harduare. For an ATP con- 
troller this will contain the date codes of the 6801's and the results fren 
selftest. For the ROCC this is unused. 

WORD 12 

DL’ DEVTYPE(12). (0:6) 

Indicates the driver type. For terninals the driver type will be 16. 

OL’ VERSION(12). (6:5) 


Indicates the current version cf the driver. For ATP the driver is 
HIOTERM1 /HIOASLPO and for the ROCC the driver is HIOTERNZ/HICASLP2. 


OL COMTROLLER(12). (11:2) 
Indicates the type of controller used by this LDEV. 


1 = ATP. 
2 - ROCC. 


DL’ S$T0(12).(13:1) 
Indicates how to procees the logon tiner that is running. 





0 - If the logon tiner expires the logon did not eccur and 
the port should be disconnected. 

1 - If the logon tiner expires the speedsense should be 
aborted and restarted. 
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DL’ UNFIXABLE (12). (14:1) 
Indicates if the port ie broken and unfixable. 


© - Port is not unfixable, but may be broken. 
1 - Port is unfixable. A warnstart of the systen will reset the port. 


DL’ GRK’ NODE(12). (15:1) 
Indicates if the device is in break node. 


0 - The device is not in break node. Cleared with an 100 
function code of 31. 

1 - The device is in break node. Set with an I0Q function 
code of 31. 


WORD 13 
DL’ LOG 


Used for systen logging. When a port failure cccurs LYNX°’ERROR will save in 
here the status register fron the stack narker. 


WORD 14 
DL’ LOGI 


Used for systen logging. When a port failure occurs LYNX’ERROR will save in 
here the P register fron the stack narker. 


WORD 15 
DL’ ERROR’ CODE 


Contains the error code uhen a port failure eccurs. The code is placed here 
by LYNX’ERROR uhen the failure cecurs. It is a 4-digit (decimal) code where 
the first tuo digits are the nodule nunber in which the error cccurred and 
the second tuo are a unique error code. 
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Line Printer Ronitor DIT Fornat 


nar 1 , 2 , 3 4 5 ' 3 , 7 8 ; 3 10 11 12 13 18 Mel 
ITE { ACT] JRE [BRO|  |TBU) TRUE HAROWRRE UNIT NUMBER | 
ORM [UP [IVEIREQISETIKEN| |FRV| CF PORT (0 - 127) | 


1] SYS 0B RELATIVE POINTER TO NEXT DIT WAITING FOR SYSIO | 


2| 100 TABLE RELATIVE POINTER TO HEAD 100 l 


3] LOGICAL DEVICE NUNBER 


4| SYS O08 RELATIVE POINTER 10 ORIVER LINKAGE TABLE 


8 SSO C08 0 9S 0GS 4 6 088888 OSE GE CESSES OSS ESOS BOENDESS OS SEOSSSESTESD“ESOEO | 


5| SYS 0B RELATIVE POINTER TO INTERRUPT LINKRGE TABLE 


|HAN] (CFA || {RE | | LOG} ; { | 
éicuP | {IL | | XON| \no | ion ack 
7| INTERRUPT RANAGER COnRUNTCATION WORD |---| 
10 RES] {PRE| WO! =| | PF| | 

iser! |sPa| STP (ua iRecl 
111 TERMINAL DST RELATIVE POINTER TO PROTOCOL & DATA MENAGER OTT | 
12] |CONFIGURED UNIT NUMBER (0 - 95)} 


od aee | eeeeoeee | ceeeeees [| eee | cea eeeeee2e2eeeE0/] Cee 


13(P/F| PCC DATE CODE [P/F] MCC DATE CODE |P/F| MSC CATE CODE |JPT} 


cee | eee eceee@e © 2822O@ | eee | Ceeeeee SOOO eeo /}| O20 seccece | one ooo ane 


14] DEVICE TYPE SUPPORTED | OUNAY ORIVER JCONTROL| [NO j | 
| VERSION | TYPE 








| BY THIS DRIVER | VERSTON MUNBER [TYPE | [rix! 
15] RESERVED FOR SYSTEM LOGGING | 
ie} RESERVED FOR SYSTEN SGD nt 
17 Ene CE es 
oo| Ten? STORAGE FOR AONITOR arenes 


| 8 OS 08 OSOSE 6 26S OSO BS OSS BOS 88S 9EOSE8 09S 88S88SEE88 0408888 O8 C08 82882 | 
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WORD 16 
OL’ TIME’ FLAG(16). (0:1) 
Indicates if the nex‘ ~ead will be tined. 
0 - The next ~+01 ts not tined. Cleared with an I0Q function 
code of ‘8. 
1 - The next read will be tined. Set with an 100 function 
code of 17 
DL’ RERD’ TVAL(16). (1:15) 


Contains the tine out value for the next read that is to be tined. Set with 
an 100 function code of 5 


OL’ TIME 


A reference tn both vead tine fields. 


WORD 17 
DL’ QPARA 


Saved 100 paraneter. 


WORD 18 
DL’ LOGN’ TRLX 


Contains the logon tine: index. 


WORO 20 

DL’ TENP 

Tenporary storage used by monitor 
WORD 19 

DL’ READ’ TINE 


For reads that are tined, DL’TINE’FLAG = 1, this will contain the read tine 
for the last read. 
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WORD O 
OL’ TERA(O). (0:1) 
Indicates if the device is a terninal. Always a one. 


0 - Device is not a terninal. 
1 - Device is a terninal. 


DL’UP(0). (1:1) 
Indicates if the device is “up”. 


0 - Device is not up. 
1 - Device is up and has been FOPEN'ed. 


OL’ ACTIVE(0). (2:1) 
Indicates the nanitor is active. 


© - The nonitor is not active. 
1 - The monitor 18 active and processing a function. 


OL’ REQUEST(0).(3:1) 
Indicates if the nonitor uas anakened while active. 


0 - There is no pending request. 
1 - The monitor was asakened while active and has a pending request. 


DL’ RESET(0). (4:1) 
Indicates if the monitor shou.d reinitialize the port. 
0 - Don’t reinitia'*ze the pert. 
1 - Reinitialize th> port. This is equivalent to doing 
an ABORTJOB or cevice close against the port. 
DL’ BROKEN(O). (5:1) 
Indicates if the port is broken. 
0 - The port 18 not broken. 
1 - The driver setected an error and marked the port 
broken. The errcr code will be in OL’ ERRGA’ CODE. 
OL’ TEUFAVAIL(O). (7:1) 


Indicates :f a TBUF is now availatie for the device. 
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DL’ TRUEUNTT (0). (8:8) 

Contains the true unit number of the device. Is only used for devices con- 
nected to an ATP controller. Unit nunbers will range fron 0 to 127. 

WORD 1 

DL’ NEXT 


WORD 2 
OL’ T0GP 


Contains an I0Q0 table relative pointer to the current J0Q. 


WORD 3 
DL’ LEV 


Contains the configured logical device nunber of the device. 


WORD 4 
DL’ OLTP 


Contains a SYS 08 relative pointer to the driver linkage table. 


WORD § 
DL’°ILTP 


Contains a SYS OB relative pointer to the interrupt linkage table. 


WORD 6 

OL’ TICK 

The TICK conmnunication word. If a tiner is running and expires the bit cor 
responding to the type of tiner is set in OL’TICK. The monitor is then 
auakened to procese the tineout. 

DL’ HANGUP’ T0(6). (0:1) 


Tiner used by the Initiation Manager uhen disconnecting a noden. 
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WORD 8 

DL’ RESETTING(8). (0:1) 

Set if the port should be reset. 

DL’ PRESPACE(8). (4:1) 

Set if the last request used prespacing. 
DL°NO’STP°OV(8). (5:1) 

Set if the driver does not perforn auto perforation skip. 
DL'WAIT(8). (6:1) 

Set if the monitor is uaiting for a request to conplete. 
DL’ PF’ REC(8). (12:1) 


Set if the nonitor should execute its pouer fail recovery code. 


WORD 9 
OL'PD'DITP 
Contains a TOS relative pointer to the Protocol and Data Manager OIT. 


Lord 10 
DL’ UNIT(‘0). (8:8) 
Contains the configured logical unit nunder of the device. It is only used 
for devices connected to the ATP controller. Unit nunbers will range fron 0 
to 95. 
WORD 11 
DL'SGTE CODE 

Contains information that indicates the level of harduare. For an ATP cen- 
troller this u:ll contain the data codes of the 6801's and the results fron 
selftest. For the ACCC this is unused. 
WORD 12 
DL DEVTYPE(12). (C:6) 

ndicates the drive: type. For printers the driver type will be 32. 
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OL’ CFAIL’ T0(6). (2:1) 


Tiner used by the Initiation Manager and Interrupt Manager when trying to 
connect a noden, waiting for DSR and OCD to cone on or uhen there is a car- 
rier fazl. 


OL' KON’ T0(6). (4:1) 





Tiner used by the Interrupt Manager when waiting for an XON. 

OL’ READ’ T0(6). (8:1) 

Tiner used by the Initiation Manager and Interrupt Manager for reads. 
DL’ LOGON’ T0(6). (11:1) 

Tiner used by the menitor for a logon tineout. 

DL’ ACK’ 70(6). (14:1) 

Tiner used by the ROCC physical driver for a 10 ENQ/ACK tineout. 


WORD 7 
DL’ INT’MAN 


The Interrupt Manager connunication word. When the Interrupt Manager needs 
to auaken the nonator it will place an interrupt code in this word and then 
auaken the monitor via AUAKETERMINAL. This uord contains 4 4-bit fields so 
that the Interrupt Manager may ausken the nonitor for nore than one reason. 
gt ee are processed by the monitor left to right. Interrupt codes are 
as follous: 


1 = Disconnect interrupt. Data set ready has dropped or carrier 
fail has occurred nore that 50 tines during the read. The 
monitor will anitiate a disconnect sequence of the noden. 


La] 
8 


Partial hardware setup. The hardware has been partially set 
up and the monitor will call the Initiation Manager to 
continue/finish setting up the harduare. 


4 - Partial write interrupt. The write uas a critical write 
or there uas an "ACK" tine out or tanking needs to be 
resuned on the urite. The monitor will call the 
Initiation Manager to continue/conplete the write. 


A] 
a 


Reset done. The reset of the port is conplete. The 
monitor will eather continue with the “open” if in the 
niddle of the “open” or start a speedsense. 
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DL’VERSION(12). (6:5) 


Indicates the current version of the driver. For ATP the driver is HICTERN 
and for ROCC the driver is HIOTERA2. 


DL’ CONTROLLER( 12). (11:2) 
Indicates the type of controller used by this LDEV. 


1 al ATP, 
2- Rocc. 


DL’ UNFIXRBLE(12). (14:1) 
Indicates if the port is broken and unfixable. 

0 - Port is not unfixable, but nay be broken. 

1 - Port is unfixable. A uarnstart of the systen will reset the port. 
WORD 13 
DL’ LOG 
Used for systen logging. When a port failure occurs LYNX’ERROR will save in 
here the status register fron the stack narker. 
WORD 14 
OL’ LOSI 
Used for systen logging. When a port failure occurs LYNX’ERROR will save in 
here the P register fron the stack narker. 
WORD 15 
DL’ ERROR’ CODE 
Contains the error code when a port failure occurs. The code is placed here 
by LYNX’ERROR when the failure occurs. It is a 4-digit (decinal) code uhere 
the first tuo digits are the nodule nunber in which the error occured and 
the second tuo are @ unique error code. 
WORD 16 
DL’ TENP 





Tenporary etorage used by monitor. 
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[UT/TLTX Fornat WORD 214 
ILT’SIOP’ SIZE. (0:8) 


ATP/ATP37_ILT Format 


Contains size, in words, of channel progran area (ILTX). 


0 1 3 6 9 10 11 12 13 14 15 
[nn= [one [one done Lone Lene Lene Lone Lone done dane dome doe dome fone le WORD 215 


0 

1| CHANNEL PROGRAN VARIABLE AREA - CPVR ILT*HUNIT. (9:7) 
2] (NOT USED - SET TO 0) 

4| DNA ABORT ADDRESS 

5| (NOT USED - SET TO 0) 


OO 8 8 SO OO OS OES 08 OS SS 6 9854 24 FEF 6 OF OSHS ES2S 2 BSTOOSSSO VAG FOCVBAF2SZECS 





Contains the highest configured unit number on the channel. 


WORD 216 


Starting at word Z16 there is a SYSDB relative pointer to the monitor DIT for 
each unit configured on the channel. 


ATP/ATP37_ ILTX Fernat 


| 
11] STATUS RETURN AREA POINTER - (NOT USED - SET TO 0) 


OPO OO SOS 2 OS OS OSSE4 SC OOF SF 64H 6824080295406 CES S88 FEST EZESRE eau sweveeceenee 


12{ UNIT EXTRACT INSTRUCTION - (NOT USED - SET TO 0) O| TERMINAL DATA SEGHENT OST NUMBER FOR 1ST OST { 
13] CURRENT DIT POINTER - (NOT USED - SET TOO) 1] TERMINAL DATA SEGRENT BANK NUNBER FOR 1ST OST | 
14] Si0° Size | COUEN 2| TERMINAL ORTA SEGHENT OST OFFSET FOR 1ST DST | 
15] CONTROLLER FLAGS - (SET 100) | MIGHESTUNIT® sip | (wT useO-seT 100) t—“‘i‘éSCSC*~*™S | 


| 
| 
| 
| 
| 
| 
| 
aches aaa appara sesessresesneninas [pion -—acasseesascesseceseansens| 
| 
| 
| 
| [ese 
4| CONTROLLER ID | 


ee eee ree eee ee ee - 
| SrS08 RELATIVE OFT POINTER FOR UNIT WON STB _ sl Gt sceeeagrroy orrorcorar onary > maa 
— eae | com ce ee ee ee | 
wise t0| TERMINAL DATA SEGRENT DST OFFSET FOR 2ND OST SSS | 
ee oer Ss sancncaan 
Contains ORT nunber for controller on channel. ai ee 


nn en aan | 


13| INTERRUPT PROCESSOR PLABEL | 








WORD 210 | momen nn nen nen nn nn nn none nnn cece nnnwennnnnwenneoneersoonscn <= 
ILT’ ISIOP 
nea a SYSOS relative pointer to the channel progran area also known as 
the ILTX. 
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a TF ADCO ILTX Fornat 
01412 3 4 § 6 7 $8 § 0% 1% 42 13 14 15 | peewee nen nnn nnn eee n enero senor nce n cen econ enenecoscocosce wooen| 
O| TERMINAL DATA SEGMENT OST NUMBER | 
| m= |am= |---| == bone == m= | ab —- | —- ne em le me de nannnnnnenennnnnnncrecesernenenacrneceennenssneenecnenseceneens | 
j 1] TERMINAL CATA SEGHENT BANK NUABER | 
1| CHANNEL PROGRAN VARIABLE RREA - CPVA | woe re wen cc ence cnc w mene cn ww nn mwn eee eneoennocewewecowococsconecen| 
a! | 2| TERMINAL DATA SEGHENT DST OFFSET ! 
woeccccocewoccocoe teeta | 3/10 | (NOT USED - SET TO 0) | 
4| DMA ABORT ROORESS { ee | con nn nnn ne nee ewe nnn n-ne sen nn nn new en occcocwcwccenococorcones | 
5| (NOT USED - SET 10 0) z CONTROLLER ID | 
sl (NOT USED - SET TO 0) ' 7 INTERRUPT PROCESSOR PLABEL ! 
tn ! CHANNEL QUEUE @ | 1° | CHANNEL | OEVICE | 6| i 
10] CHRNNEL PROGRAM POINTER - ILTX ! 315] ADCC CHANNEL PROGRAM 
11] STATUS RETURN AREA POINTER - (NOT USED - SET TO 0) 
12| UNIT EXTRACT INSTRUCTION - (NOT USEO - SET TO 0) 
13] CURRENT DIT POINTER - (NOT | - SET TO 0) 
14| SIOP SIZE { sa | 
15] CONTROLLER FLAGS - (SET 10 0) | HIGHEST UNIT @ 
16| SYSDB RELATIVE DIT POINTER ! 
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